UserControl.Load Ereignis
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.
