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