英語で読む

次の方法で共有


UserControl.Load イベント

定義

コントロールが初めて表示される前に発生します。

public event EventHandler Load;
public event EventHandler? Load;

イベントの種類

次のコード例では、このメンバーの使用方法を示します。 この例では、イベント ハンドラーがイベントの 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.");
}

注釈

このイベントを使用すると、コントロールによって使用されるリソースの割り当てなどのタスクを実行できます。

注意

UserControlが MDI 子フォームの一部である場合、Load子フォームが表示されるたびにイベントが発生します。 この場合は、イベント ハンドラーではなく、 に UserControl 1 回限りの初期化コードを配置する Load 必要があります。

注意事項

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

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

適用対象

製品 バージョン
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

こちらもご覧ください