UserControl.Load 事件

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

在控件第一次变为可见之前发生。

public:
 event EventHandler ^ Load;

public event EventHandler? Load;

member this.Load : EventHandler 

Public Custom Event Load As EventHandler 

事件类型

EventHandler

示例

下面的代码示例演示了此成员的用法。 在此示例中，事件处理程序报告事件的发生情况 Load 。 此报表可帮助你了解事件发生的时间，并可以帮助你进行调试。 若要报告多个事件或频繁发生的事件，请考虑将 MessageBox.Show 替换为 Console.WriteLine 或将消息追加到多行 TextBox。

若要运行示例代码，请将其粘贴到包含名为 UserControl1的 类型的UserControl实例的项目中。 然后，确保事件处理程序与 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 method。) 若要解释 Load 多次发生的事件，应将任何一次初始化代码放在构造函数中 UserControl ，而不是 Load 事件处理程序中。 此外，不应将数据绑定添加到 UserControl 事件处理程序中的 Load 。

有关处理事件的详细信息，请参阅 处理和引发事件。

另请参阅

• OnLoad(EventArgs)
• Load