UserControl.Load Zdarzenie

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

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

EventHandler

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 często występujących zdarzeń, rozważ zastąpienie MessageBox.Show komunikatu ciągiem Console.WriteLine lub dołączenie 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

Jeśli element UserControl 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ć jednorazowy kod inicjowania w UserControl programie obsługi zdarzeń zamiast programu obsługi zdarzeń Load .

Przestroga

Zdarzenie Load występuje po utworzeniu dojścia do pliku 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 odtworzone. (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 podnoszenie zdarzeń.

Dotyczy

Zobacz też