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
Poniższy przykład kodu przedstawia użycie tego elementu członkowskiego. W tym przykładzie program obsługi zdarzeń zgłasza wystąpienie zdarzenia Load . 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ę.
Uwaga
UserControl Jeśli element jest częścią formularza podrzędnego MDI, Load zdarzenie będzie wykonywane za każdym razem, 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 Load programu obsługi zdarzeń.
Przestroga
Zdarzenie Load występuje po utworzeniu uchwytu dla tego modułu 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 uchwyt zostanie ponownie utworzony. (Jednym ze sposobów ponownego utworzenia uchwytu RecreateHandle jest wywołanie metody). Aby uwzględnić Load zdarzenie występujące więcej niż jeden raz, należy umieścić dowolny jednorazowy kod inicjowania w konstruktorze UserControl zamiast Load programu obsługi zdarzeń. 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 podnoszenie zdarzeń.
