UserControl.Load UserControl.Load UserControl.Load UserControl.Load Event

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 de la Load eventos.In the example, an event handler reports on the occurrence of the Load event. Este informe le ayuda a saber cuándo el evento se produce y puede ayudarle a depurar.This report helps you to learn when the event occurs and can assist you in debugging. Para informar sobre varios eventos o en eventos que se producen con frecuencia, considere reemplazar MessageBox.Show con Console.WriteLine o agregar el mensaje a un multilínea TextBox.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 ejemplo de código, péguelo en un proyecto que contiene una instancia del tipo UserControl denominado UserControl1.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 está asociado el controlador de eventos con el Load eventos.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 usar 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 forma parte de un formulario MDI secundario, el Load evento se producirá cada vez que se muestra 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 el UserControl en 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 se produce cuando el identificador de la UserControl se crea.The Load event occurs when the handle for the UserControl is created. En algunos casos, esto puede causar la Load eventos que 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 tiene lugar cuando el UserControl está cargado y vuelva a 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 manera de que se vuelve a crear un identificador es mediante una llamada a la RecreateHandle método.) Para tener en cuenta la Load eventos que se producen más de una vez, debe colocar el código de inicialización en cualquier momento el UserControl constructor en lugar de un Load 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 para el 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: