UserControl.Load Событие

Определение

Происходит перед тем, как элемент управления первый раз становится видимым.

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

Тип события

Примеры

В следующем примере кода показано использование этого элемента. В этом примере обработчик событий сообщает о возникновении Load события. Этот отчет поможет вам узнать, когда происходит событие, и может помочь в отладке. Чтобы сообщить о нескольких событиях или о событиях, которые происходят часто, рекомендуется заменить MessageBox.ShowConsole.WriteLine сообщение на или добавить его в многостроочный TextBox.

Чтобы выполнить пример кода, вставьте его в проект, содержащий экземпляр типа UserControl с именем UserControl1. Затем убедитесь, что обработчик событий связан с событием Load .

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

Комментарии

Это событие можно использовать для выполнения таких задач, как выделение ресурсов, используемых элементом управления.

Примечание

UserControl Если является частью дочерней формы MDI, Load событие будет происходить при каждом отображении дочерней формы. В этом случае следует поместить любой код одноразовой инициализации в UserControl вместо обработчика Load событий.

Внимание!

Это Load событие возникает при создании дескриптора UserControl для . В некоторых случаях это может привести к тому Load , что событие происходит несколько раз. Например, Load событие возникает при загрузке UserControl и повторное создание дескриптора. (Один из способов повторного создания дескриптора — вызов RecreateHandle метода.) Чтобы учесть Load событие, возникающее несколько раз, следует поместить любой код однократной инициализации в UserControl конструктор вместо обработчика Load событий. Кроме того, не следует добавлять привязки данных в UserControl в обработчике Load событий.

Дополнительные сведения об обработке событий см. в разделе Обработка и вызов событий.

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

См. также раздел