UserControl.Load Evento

Definizione

Si verifica prima che il controllo sia visibile per la prima volta.

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

Tipo evento

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questo membro. Nell'esempio un gestore eventi segnala l'occorrenza dell'evento Load . Questo report consente di apprendere quando si verifica l'evento e può essere utile per il debug. Per segnalare più eventi o eventi che si verificano di frequente, provare a sostituire MessageBox.Show o Console.WriteLine accodare il messaggio a un oggetto multilinea TextBox.

Per eseguire il codice di esempio, incollarlo in un progetto contenente un'istanza di tipo UserControl denominata UserControl1. Assicurarsi quindi che il gestore eventi sia associato all'evento 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

Commenti

È possibile usare questo evento per eseguire attività quali l'allocazione di risorse usate dal controllo .

Nota

Se fa UserControl parte di un modulo figlio MDI, l'evento Load verrà generato ogni volta che viene visualizzato il modulo figlio. In questo caso, è necessario inserire qualsiasi codice di inizializzazione una tantum invece UserControl di un Load gestore eventi.

Attenzione

L'evento Load si verifica quando viene creato l'handle per .UserControl In alcuni casi, questo può causare l'evento Load più di una volta. Ad esempio, l'evento Load si verifica quando UserControl viene caricato e di nuovo se l'handle viene ricreato. Un modo in cui viene ricreato un handle consiste nel chiamare il RecreateHandle metodo . Per tenere conto dell'evento Load che si verifica più volte, è necessario inserire un codice di inizializzazione una sola volta nel UserControl costruttore invece di un Load gestore eventi. Inoltre, non è consigliabile aggiungere data binding a UserControl in un Load gestore eventi.

Per ulteriori informazioni sulla gestione degli eventi, consultare gestione e generazione di eventi.

Si applica a

Vedi anche