Freigeben über


UserControl.Load Ereignis

Definition

Tritt ein, bevor das Steuerelement zum ersten Mal angezeigt wird.

public:
 event EventHandler ^ Load;
public event EventHandler Load;
public event EventHandler? Load;
member this.Load : EventHandler 
Public Custom Event Load As EventHandler 

Ereignistyp

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Members veranschaulicht. Im Beispiel meldet ein Ereignishandler das Auftreten des Ereignisses Load . Dieser Bericht hilft Ihnen, zu erfahren, wann das Ereignis eintritt, und kann Sie beim Debuggen unterstützen. Um über mehrere Ereignisse oder ereignisse zu berichten, die häufig auftreten, sollten Sie die Nachricht durch Console.WriteLine ein mehrlineiges TextBoxersetzen MessageBox.Show oder anfügen.

Um den Beispielcode auszuführen, fügen Sie ihn in ein Projekt ein, das eine instance des Typs UserControl enthältUserControl1. Stellen Sie dann sicher, dass der Ereignishandler dem Load Ereignis zugeordnet ist.

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

Hinweise

Sie können dieses Ereignis verwenden, um Aufgaben auszuführen, z. B. das Zuweisen von Ressourcen, die vom Steuerelement verwendet werden.

Hinweis

Wenn das UserControl Teil eines untergeordneten MDI-Formulars ist, tritt das Load Ereignis jedes Mal auf, wenn das untergeordnete Formular angezeigt wird. In diesem Fall sollten Sie jeden einmaligen Initialisierungscode anstelle eines Load Ereignishandlers einfügenUserControl.

Achtung

Das Load Ereignis tritt auf, wenn das Handle für erstellt UserControl wird. In einigen Fällen kann dies dazu führen, dass das Load Ereignis mehr als einmal auftritt. Das -Ereignis tritt beispielsweise auf, Load wenn geladen UserControl wird, und erneut, wenn das Handle neu erstellt wird. (Eine Möglichkeit, ein Handle neu zu erstellen, ist das Aufrufen der RecreateHandle -Methode.) Um das Ereignis zu berücksichtigen, das Load mehrmals auftritt, sollten Sie einen beliebigen Einmalinitialisierungscode anstelle eines Load Ereignishandlers in den UserControl Konstruktor einfügen. Darüber hinaus sollten Sie in UserControl einem Load Ereignishandler keine Datenbindungen hinzufügen.

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.

Gilt für:

Weitere Informationen