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

要執行範例程式碼,請將其貼到包含一個 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

備註

你可以利用此事件執行任務,例如分配控制組使用的資源。

Note

若 是 MDI UserControl 子表單的一部分,則每次顯示子表單時都會觸發該 Load 事件。 在這種情況下,你應該將任何一次性初始化程式碼放入 , UserControl 而不是事件 Load 處理器。

注意事項

Load事件發生於 的 handle UserControl 被建立時。 在某些情況下,這可能導致該 Load 事件發生不只一次。 例如, Load 當 被載入時 UserControl ,以及當 handle 被重新建立時,事件也會發生。 (重建句柄的一種方式是呼叫該 RecreateHandle 方法。)為了考慮 Load 事件發生多次,你應該在建構子中放入任何一次性初始化程式碼 UserControl ,而非事件 Load 處理器。 此外,事件處理程序中不應為 新增資料綁定UserControlLoad

如需處理事件的詳細資訊,請參閱 處理和引發事件

適用於

另請參閱