UserControl.Load Evento
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.
