UserControl.Load Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Se produit avant que le contrôle ne 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 à apprendre 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 ou d’ajouter le message à un multiligne TextBox.
Pour exécuter l’exemple de code, collez-le dans un projet qui contient une instance de type UserControl nommée 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 de ressources utilisées par le contrôle.
Note
Si la UserControl partie fait 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 un UserControl code d’initialisation unique au lieu d’un gestionnaire d’événements Load .
Avertissement
L’événement Load se produit lorsque le handle de l’objet UserControl est créé. Dans certaines circonstances, cela peut entraîner la survenue de l’événement Load plusieurs fois. Par exemple, l’événement Load se produit lorsque le UserControl chargement est effectué, puis à nouveau si le handle est recréé. (Une façon dont un handle est recréé 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 gestionnaire d’événements Load . En outre, vous ne devez pas ajouter de liaisons de données au UserControl gestionnaire d’événements Load .
Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.
