UserControl.Load Händelse

Definition

Inträffar innan kontrollen blir synlig för första gången.

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

Händelsetyp

Exempel

Följande kodexempel visar hur den här medlemmen används. I exemplet rapporterar en händelsehanterare om händelsens Load förekomst. Den här rapporten hjälper dig att lära dig när händelsen inträffar och kan hjälpa dig att felsöka. Om du vill rapportera om flera händelser eller händelser som inträffar ofta kan du överväga att MessageBox.Show ersätta med Console.WriteLine eller lägga till meddelandet i en flerradig TextBox.

Om du vill köra exempelkoden klistrar du in den i ett projekt som innehåller en instans av typen UserControl med namnet UserControl1. Kontrollera sedan att händelsehanteraren är associerad med Load händelsen.

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

Kommentarer

Du kan använda den här händelsen för att utföra uppgifter som att allokera resurser som används av kontrollen.

Note

UserControl Om är en del av ett underordnat Load MDI-formulär inträffar händelsen varje gång det underordnade formuläret visas. I det här fallet bör du placera en engångsinitieringskod i UserControl stället för en Load händelsehanterare.

Caution

Händelsen Load inträffar när handtaget för UserControl skapas. I vissa fall kan detta orsaka Load att händelsen inträffar mer än en gång. Händelsen inträffar till exempel Load när den UserControl läses in och igen om handtaget återskapas. (Ett sätt att återskapa ett handtag är genom att anropa RecreateHandle metoden.) Om du vill ta hänsyn till händelsen Load som inträffar mer än en gång bör du placera en engångsinitieringskod i konstruktorn i UserControl stället för en Load händelsehanterare. Dessutom bör du inte lägga till databindningar till UserControl i en Load händelsehanterare.

Mer information om hur du hanterar händelser finns i Hantera och höja händelser.

Gäller för

Se även