UserControl.Load Evento
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Si verifica prima che il controllo diventi visibile per la prima volta.
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 di facilitare il debug. Per segnalare più eventi o eventi che si verificano frequentemente, è consigliabile sostituire MessageBox.Show con Console.WriteLine o 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 .
Note
Se fa UserControl parte di un form figlio MDI, l'evento Load si verifica ogni volta che viene visualizzato il modulo figlio. In questo caso, è necessario inserire qualsiasi codice di inizializzazione monouso nel UserControl anziché in un Load gestore eventi.
Caution
L'evento Load si verifica quando viene creato l'handle per .UserControl In alcune circostanze, 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 codice di inizializzazione una sola volta nel UserControl costruttore anziché un Load gestore eventi. Inoltre, non è consigliabile aggiungere associazioni dati a UserControl in un Load gestore eventi.
Per ulteriori informazioni sulla gestione degli eventi, consultare gestione e generazione di eventi.