Compartir a través de


UserControl.Load Evento

Definición

Se produce antes de que el control esté visible por primera vez.

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

Tipo de evento

Ejemplos

En el ejemplo de código siguiente se muestra el uso de este miembro. En el ejemplo, un controlador de eventos informa sobre la aparición del Load evento. Este informe le ayuda a aprender cuándo se produce el evento y puede ayudarle a depurar. Para informar sobre varios eventos o eventos que se producen con frecuencia, considere la posibilidad de reemplazar MessageBox.Show por Console.WriteLine o anexar el mensaje a una línea TextBoxmúltiple.

Para ejecutar el código de ejemplo, péguelo en un proyecto que contenga una instancia de tipo UserControl denominada UserControl1. A continuación, asegúrese de que el controlador de eventos está asociado al Load evento.

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

Comentarios

Puede usar este evento para realizar tareas como la asignación de recursos utilizados por el control.

Nota

UserControl Si forma parte de un formulario secundario MDI, el Load evento se producirá cada vez que se muestre el formulario secundario. En este caso, debe colocar cualquier código de inicialización único en en UserControl lugar de en un Load controlador de eventos.

Precaución

El Load evento tiene lugar cuando se crea el identificador de .UserControl En algunas circunstancias, esto puede hacer que el Load evento se produzca más de una vez. Por ejemplo, el Load evento se produce cuando UserControl se carga y, de nuevo, si se vuelve a crear el identificador. (Una forma en que se vuelve a crear un identificador es llamando al RecreateHandle método ). Para tener en cuenta que el Load evento se produce más de una vez, debe colocar cualquier código de inicialización de una vez en el UserControl constructor en lugar de un Load controlador de eventos. Además, no debe agregar enlaces de datos a UserControl en un Load controlador de eventos.

Para obtener más información sobre el manejo de eventos, consulte controlar y provocar eventos.

Se aplica a

Consulte también