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. Чтобы сообщить о нескольких событиях или о событиях, которые происходят часто, рассмотрите Console.WriteLine возможность замены MessageBox.Show или добавления сообщения в многострочный 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 с именем. UserControl1To 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.

Примечание

Если компонент Load является частью дочерней MDI-формы, событие будет происходить каждый раз, когда будет показана дочерняя форма. UserControlIf 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.

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

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