UserControl.Load 事件
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
在控件第一次变为可见之前发生。
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 事件处理程序中。
注意
创建 Load 的 UserControl 句柄时发生 该事件。 在某些情况下,这可能会导致 Load 事件多次发生。 例如, 事件在 Load 加载 时 UserControl 发生,如果重新创建句柄,则再次发生。 (重新创建句柄的一种方法是调用 RecreateHandle method。) 若要解释 Load 多次发生的事件,应将任何一次初始化代码放在构造函数中 UserControl ,而不是 Load 事件处理程序中。 此外,不应将数据绑定添加到 UserControl 事件处理程序中的 Load 。
有关处理事件的详细信息,请参阅 处理和引发事件。