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.

참고

경우는 UserControl MDI 자식 폼의 일부인는 Load 이벤트가 자식 폼이 표시 될 때마다 발생 합니다.If the UserControl is part of an MDI child form, the Load event will occur each time the child form is shown. 이 경우에 일회 초기화 코드를 입력 해야 합니다 UserControl of를 Load 이벤트 처리기입니다.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. (첫 번째는 핸들을 다시 만드는 방법은 호출 하 여는 RecreateHandle 메서드.) 고려 하는 Load 이벤트가 여러 번 발생 하 번의 초기화 코드를 배치 해야 합니다 UserControl 대신 생성자를 Load 이벤트 처리기.(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. 또한 추가 해서는 안에 대 한 데이터 바인딩을 합니다 UserControlLoad 이벤트 처리기입니다.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.

적용 대상

추가 정보