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 イベントの発生を報告します。 このレポートは、イベントがいつ発生するかを学習するのに役立ち、デバッグに役立ちます。 複数のイベントや頻繁に発生するイベントについて報告するには、 MessageBox.Show を Console.WriteLine に置き換えるか、メッセージを複数行の TextBoxに追加することを検討してください。
コード例を実行するには、UserControlという名前の型のインスタンスを含むプロジェクトUserControl1貼り付けます。 次に、イベント ハンドラーが 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
注釈
このイベントを使用して、コントロールで使用されるリソースの割り当てなどのタスクを実行できます。
Note
UserControlが MDI 子フォームの一部である場合、子フォームが表示されるたびにLoad イベントが発生します。 この場合は、UserControl イベント ハンドラーではなく、Loadに 1 回限りの初期化コードを配置する必要があります。
Caution
Load イベントは、UserControlのハンドルが作成されるときに発生します。 状況によっては、 Load イベントが複数回発生する可能性があります。 たとえば、 Load イベントは、 UserControl が読み込まれるときに発生し、ハンドルが再作成された場合にも発生します。 (ハンドルを再作成する 1 つの方法は、RecreateHandle メソッドを呼び出すことです)。複数回発生するLoad イベントを考慮するには、UserControl イベント ハンドラーではなく、Load コンストラクターに 1 回限りの初期化コードを配置する必要があります。 さらに、UserControl イベント ハンドラーのLoadにデータ バインディングを追加しないでください。
イベントの処理の詳細については、「処理とイベントの発生」を参照してください。
