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 auf, bevor das Steuerelement zum ersten Mal sichtbar 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 Elements veranschaulicht. Im Beispiel meldet ein Ereignishandler das Auftreten des Load Ereignisses. Dieser Bericht hilft Ihnen, zu erfahren, wann das Ereignis auftritt und Sie beim Debuggen unterstützen kann. Wenn Sie über mehrere Ereignisse oder ereignisse berichten möchten, die häufig auftreten, erwägen Sie, die Nachricht durch MessageBox.Show eine mehrteilige Console.WriteLineNachricht zu ersetzen TextBox oder sie anzufügen.
Um den Beispielcode auszuführen, fügen Sie ihn in ein Projekt ein, das eine Instanz des Typs UserControl namens UserControl1enthält. 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 Zuordnen von Ressourcen, die vom Steuerelement verwendet werden.
Note
Wenn der 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 einen einmaligen Initialisierungscode anstelle UserControl eines Load Ereignishandlers platzieren.
Vorsicht
Das Load Ereignis tritt auf, wenn das Handle für das UserControl Ereignis erstellt wird. In einigen Fällen kann dies dazu führen, dass das Load Ereignis mehr als einmal auftritt. Das Ereignis tritt beispielsweise auf, wenn das LoadUserControl Ereignis geladen wird, und erneut, wenn das Handle neu erstellt wird. (Eine Möglichkeit, ein Handle neu zu erstellen, besteht darin, die RecreateHandle Methode aufzurufen.) Um das Ereignis zu berücksichtigen, das Load mehr als ein Mal auftritt, sollten Sie einen beliebigen Initialisierungscode in den UserControl Konstruktor anstelle eines Load Ereignishandlers einfügen. Darüber hinaus sollten Sie dem UserControl Ereignishandler Load keine Datenbindungen hinzufügen.
Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.
