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.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 事件处理程序中。

注意

创建 LoadUserControl 句柄时发生 该事件。 在某些情况下,这可能会导致 Load 事件多次发生。 例如, 事件在 Load 加载 时 UserControl 发生,如果重新创建句柄,则再次发生。 (重新创建句柄的一种方法是调用 RecreateHandle method。) 若要解释 Load 多次发生的事件,应将任何一次初始化代码放在构造函数中 UserControl ,而不是 Load 事件处理程序中。 此外,不应将数据绑定添加到 UserControl 事件处理程序中的 Load

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

适用于

另请参阅