Udostępnij za pośrednictwem


UserControl.Load Zdarzenie

Definicja

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ń.

Dotyczy

Zobacz też