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.ShowConsole.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