UserControl.Load Evento

Definición

Se produce antes de que el control esté visible por primera vez.Occurs before the control becomes visible for the first time.

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

Ejemplos

En el ejemplo de código siguiente se muestra el uso de este miembro.The following code example demonstrates the use of this member. En el ejemplo, un controlador de eventos informa sobre la aparición del Load evento.In the example, an event handler reports on the occurrence of the Load event. Este informe le ayuda a saber cuándo se produce el evento y puede ayudarle a depurar.This report helps you to learn when the event occurs and can assist you in debugging. Para notificar varios eventos o eventos que se producen con frecuencia, considere MessageBox.Show la Console.WriteLine posibilidad de reemplazar por o anexar el TextBoxmensaje a una multilínea.To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

Para ejecutar el código de ejemplo, péguelo en un proyecto que contenga una instancia de UserControl tipo UserControl1denominada.To run the example code, paste it into a project that contains an instance of type UserControl named UserControl1. A continuación, asegúrese de que el controlador de eventos Load está asociado al evento.Then ensure that the event handler is associated with the Load event.

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 utilizar este evento para realizar tareas como la asignación de recursos utilizados por el control.You can use this event to perform tasks such as allocating resources used by the control.

Nota

Si el UserControl elemento forma parte de un formulario MDI secundario, Load el evento se producirá cada vez que se muestre el formulario secundario.If the UserControl is part of an MDI child form, the Load event will occur each time the child form is shown. En este caso, debe colocar cualquier código de inicialización única en en UserControl lugar de un Load controlador de eventos.In this case, you should put any one-time initialization code in the UserControl instead of a Load event handler.

Precaución

El Load evento tiene lugar cuando UserControl se crea el identificador de.The Load event occurs when the handle for the UserControl is created. En algunas circunstancias, esto puede hacer que Load el evento se produzca más de una vez.In some circumstances, this can cause the Load event to occur more than one time. Por ejemplo, el Load evento se produce UserControl cuando se carga y de nuevo si se vuelve a crear el identificador.For example, the Load event occurs when the UserControl is loaded, and again if the handle is recreated. (Una forma de volver a crear un controlador es llamando al RecreateHandle método). Para tener en cuenta Load que el evento se produce más de una vez, debe colocar cualquier código de inicialización UserControl de una vez en el Load constructor en lugar de un controlador de eventos.(One way that a handle is recreated is by calling the RecreateHandle method.) To account for the Load event occurring more than one time, you should put any one time initialization code in the UserControl constructor instead of a Load event handler. Además, no debe agregar enlaces de datos a UserControl en un Load controlador de eventos.In addition, you should not add data bindings to the UserControl in a Load event handler.

Para obtener más información sobre el manejo de eventos, consulte controlar y provocar eventos.For more information about handling events, see Handling and Raising Events.

Se aplica a

Consulte también: