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.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 事件处理程序中。
Caution
创建 Load 句柄 UserControl 时发生该事件。 在某些情况下,这可能会导致 Load 事件多次发生。 例如, Load 加载该事件时 UserControl 发生,如果重新创建句柄,则再次发生该事件。 (重新创建句柄的一种方法是通过调用 RecreateHandle 方法。若要考虑 Load 多次发生的事件,应在构造函数中 UserControl 放置任何一次初始化代码,而不是 Load 事件处理程序。 此外,不应将数据绑定添加到 UserControl 事件处理程序中 Load 。
有关处理事件的详细信息,请参阅 处理和引发事件。