UserControl.Load イベント

定義

コントロールが初めて表示される前に発生します。Occurs before the control becomes visible for the first time.

public:
 event EventHandler ^ Load;
public event EventHandler Load;
member this.Load : EventHandler 
Public Custom Event Load As EventHandler 

このメンバーの使用例を次のコード例に示します。The following code example demonstrates the use of this member. この例では、イベントハンドラーがLoadイベントの発生を報告します。In the example, an event handler reports on the occurrence of the Load event. このレポートは、イベントがいつ発生し、デバッグに役立つかを理解するのに役立ちます。This report helps you to learn when the event occurs and can assist you in debugging. 複数のイベントまたは頻繁に発生するイベントについてレポートMessageBox.ShowするConsole.WriteLineには、メッセージをに置き換えるTextBoxか、または複数行に追加することを検討してください。To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

コード例を実行するには、という名前UserControl UserControl1の型のインスタンスを含むプロジェクトに貼り付けます。To run the example code, paste it into a project that contains an instance of type UserControl named UserControl1. 次に、イベントハンドラーがLoadイベントに関連付けられていることを確認します。Then ensure that the event handler is associated with the Load event.

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

注釈

このイベントを使用して、コントロールによって使用されるリソースの割り当てなどのタスクを実行できます。You can use this event to perform tasks such as allocating resources used by the control.

注意

が MDI 子フォームの一部である場合、子Loadフォームが表示されるたびにイベントが発生します。 UserControlIf the UserControl is part of an MDI child form, the Load event will occur each time the child form is shown. この場合は、 UserControl Loadイベントハンドラーではなく、1回限りの初期化コードをに配置する必要があります。In this case, you should put any one-time initialization code in the UserControl instead of a Load event handler.

注意事項

イベントLoadは、 UserControlのハンドルが作成されるときに発生します。The Load event occurs when the handle for the UserControl is created. 状況によっては、これにLoadよってイベントが複数回発生する可能性があります。In some circumstances, this can cause the Load event to occur more than one time. たとえばLoad 、イベントは、 UserControlが読み込まれたとき、およびハンドルが再作成された場合に発生します。For example, the Load event occurs when the UserControl is loaded, and again if the handle is recreated. (ハンドルを再作成する方法の1つは、 RecreateHandleメソッドを呼び出すことです)。イベントがLoad複数回発生することを考慮して、 Loadイベントハンドラーではなく、 UserControlコンストラクターに1回限りの初期化コードを配置する必要があります。(One way that a handle is recreated is by calling the RecreateHandle method.) To account for the Load event occurring more than one time, you should put any one time initialization code in the UserControl constructor instead of a Load event handler. また、 UserControl Loadイベントハンドラーのにデータバインディングを追加しないでください。In addition, you should not add data bindings to the UserControl in a Load event handler.

イベントの処理の詳細については、「処理とイベントの発生」を参照してください。For more information about handling events, see Handling and Raising Events.

適用対象

こちらもご覧ください