UserControl.Load Событие

Определение

Происходит перед тем, как элемент управления первый раз становится видимым.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 

Примеры

В следующем примере кода показано использование этого элемента.The following code example demonstrates the use of this member. В этом примере обработчик событий сообщает о возникновении события Load.In the example, an event handler reports on the occurrence of the Load event. Этот отчет поможет вам узнать, когда происходит событие и может помочь при отладке.This report helps you to learn when the event occurs and can assist you in debugging. Чтобы сообщить о нескольких событиях или событиях, которые происходят часто, попробуйте заменить MessageBox.Show Console.WriteLine или добавив сообщение в многострочный 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.

Чтобы выполнить пример кода, вставьте его в проект, содержащий экземпляр типа UserControl с именем UserControl1.To run the example code, paste it into a project that contains an instance of type UserControl named UserControl1. Затем убедитесь, что обработчик событий связан с событием Load.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

Комментарии

Это событие можно использовать для выполнения таких задач, как выделение ресурсов, используемых элементом управления.You can use this event to perform tasks such as allocating resources used by the control.

Примечание

Если UserControl является частью дочерней MDI-формы, событие Load будет происходить при каждом отображении дочерней формы.If the UserControl is part of an MDI child form, the Load event will occur each time the child form is shown. В этом случае необходимо разместить код однократной инициализации в UserControl, а не Load обработчике событий.In this case, you should put any one-time initialization code in the UserControl instead of a Load event handler.

Внимание!

Событие Load возникает при создании маркера для UserControl.The Load event occurs when the handle for the UserControl is created. В некоторых случаях это может привести к возникновению Load события более одного раза.In some circumstances, this can cause the Load event to occur more than one time. Например, событие Load возникает при загрузке UserControl и при повторном создании маркера.For example, the Load event occurs when the UserControl is loaded, and again if the handle is recreated. (Один из способов повторного создания маркера — вызов метода RecreateHandle.) Чтобы учитывать Load событие, возникающее более одного раза, следует разместить любой код инициализации в конструкторе UserControl, а не обработчике событий Load.(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. Кроме того, не следует добавлять привязки данных к UserControl в обработчике событий Load.In addition, you should not add data bindings to the UserControl in a Load event handler.

Дополнительные сведения об обработке событий см. в разделе обработка и вызов событий.For more information about handling events, see Handling and Raising Events.

Применяется к

Дополнительно