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 発生を報告します。 このレポートは、イベントが発生したタイミングを確認するのに役立ち、デバッグに役立ちます。 複数のイベントまたは頻繁に発生するイベントを報告するには、 を Console.WriteLine に置き換えるかMessageBox.Show、複数行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 1 回限りの初期化コードを配置する Load 必要があります。

注意事項

イベントは Load 、 のハンドル UserControl が作成されるときに発生します。 状況によっては、イベントが Load 複数回発生する可能性があります。 たとえば、 が Load 読み込まれるときに UserControl イベントが発生し、ハンドルが再作成された場合にもイベントが発生します。 (ハンドルを再作成する方法の 1 つは、 メソッドを RecreateHandle 呼び出すことです)。複数の時刻に発生するイベントを Load 考慮するには、イベント ハンドラーではなくコンストラクターに UserControl 1 回限りの初期化コードを配置する Load 必要があります。 さらに、イベント ハンドラーの にデータ バインディングをUserControlLoad追加しないでください。

イベントの処理の詳細については、「処理とイベントの発生」を参照してください。

適用対象

こちらもご覧ください