UserControl.Load Événement

Définition

Se produit avant que le contrôle devienne visible pour la première fois.

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

Type d'événement

Exemples

L’exemple de code suivant illustre l’utilisation de ce membre. Dans l’exemple, un gestionnaire d’événements signale l’occurrence de l’événement Load . Ce rapport vous aide à savoir quand l’événement se produit et peut vous aider à déboguer. Pour signaler plusieurs événements ou événements qui se produisent fréquemment, envisagez de MessageBox.ShowConsole.WriteLine remplacer par ou d’ajouter le message à un multiligne TextBox.

Pour exécuter l’exemple de code, collez-le dans un projet qui contient un instance de type UserControl nommé UserControl1. Vérifiez ensuite que le gestionnaire d’événements est associé à l’événement 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

Remarques

Vous pouvez utiliser cet événement pour effectuer des tâches telles que l’allocation des ressources utilisées par le contrôle.

Notes

Si fait UserControl partie d’un formulaire enfant MDI, l’événement Load se produit chaque fois que le formulaire enfant est affiché. Dans ce cas, vous devez placer tout code d’initialisation à usage unique dans le UserControl au lieu d’un Load gestionnaire d’événements.

Attention

L’événement Load se produit lorsque le handle du UserControl est créé. Dans certaines circonstances, l’événement Load peut se produire plusieurs fois. Par exemple, l’événement Load se produit lorsque est UserControl chargé, et à nouveau si le handle est recréé. (Une façon de recréer un handle consiste à appeler la RecreateHandle méthode.) Pour tenir compte de l’événement Load qui se produit plusieurs fois, vous devez placer un code d’initialisation unique dans le UserControl constructeur au lieu d’un Load gestionnaire d’événements. En outre, vous ne devez pas ajouter de liaisons de données à dans UserControl un gestionnaire d’événements Load .

Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.

S’applique à

Voir aussi