UserControl.Load Zdarzenie
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Występuje, zanim kontrolka stanie się widoczna po raz pierwszy.
public:
event EventHandler ^ Load;public event EventHandler Load;public event EventHandler? Load;member this.Load : EventHandler Public Custom Event Load As EventHandler Typ zdarzenia
Przykłady
W poniższym przykładzie kodu pokazano użycie tego elementu członkowskiego. W tym przykładzie program obsługi zdarzeń zgłasza wystąpienie Load zdarzenia. Ten raport pomaga dowiedzieć się, kiedy wystąpi zdarzenie, i może pomóc w debugowaniu. Aby zgłosić wiele zdarzeń lub zdarzeń, które występują często, rozważ zastąpienie MessageBox.Show komunikatu ciągiem Console.WriteLine lub dołączeniem go do wielowierszowego TextBoxelementu .
Aby uruchomić przykładowy kod, wklej go w projekcie zawierającym wystąpienie typu UserControl o nazwie UserControl1. Następnie upewnij się, że program obsługi zdarzeń jest skojarzony ze zdarzeniem Load .
private void UserControl1_Load(Object sender, EventArgs e) {
MessageBox.Show("You are in the UserControl.Load event.");
}
Private Sub UserControl1_Load(sender as Object, e as EventArgs) _
Handles UserControl1.Load
MessageBox.Show("You are in the UserControl.Load event.")
End Sub
Uwagi
To zdarzenie służy do wykonywania zadań, takich jak przydzielanie zasobów używanych przez kontrolkę.
Note
UserControl Jeśli element jest częścią formularza podrzędnego MDI, zdarzenie będzie wykonywane za każdym razem, Load gdy zostanie wyświetlony formularz podrzędny. W takim przypadku należy umieścić dowolny jednorazowy kod inicjowania w UserControl programie obsługi zdarzeń zamiast programu obsługi zdarzeń Load .
Caution
Zdarzenie Load występuje po utworzeniu dojścia dla elementu UserControl . W niektórych okolicznościach może to spowodować Load wystąpienie zdarzenia więcej niż jeden raz. Na przykład Load zdarzenie występuje po załadowaniu UserControl , a następnie ponownie, jeśli dojście zostanie ponownie stworzone. (Jednym ze sposobów ponownego utworzenia uchwytu jest wywołanie RecreateHandle metody ). Aby uwzględnić Load zdarzenie występujące więcej niż jeden raz, należy umieścić w konstruktorze UserControl jednorazowy kod inicjowania zamiast programu obsługi zdarzeń Load . Ponadto nie należy dodawać powiązań danych do UserControl programu obsługi zdarzeń Load .
Aby uzyskać więcej informacji na temat obsługi zdarzeń, zobacz Obsługa i wywoływanie zdarzeń.
