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 発生を報告します。 このレポートは、イベントが発生したタイミングを確認するのに役立ち、デバッグに役立ちます。 複数のイベントまたは頻繁に発生するイベントを報告するには、 を 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追加しないでください。
イベントの処理の詳細については、「処理とイベントの発生」を参照してください。
適用対象
製品 | バージョン |
---|---|
.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 |