Partilhar via


UserControl.Load Evento

Definição

Ocorre antes que o controle fica visível pela primeira vez.

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

Tipo de evento

Exemplos

O exemplo de código a seguir demonstra o uso desse membro. No exemplo, um manipulador de eventos relata a ocorrência do Load evento. Este relatório ajuda você a aprender quando o evento ocorre e pode ajudá-lo na depuração. Para relatar vários eventos ou eventos que ocorrem com frequência, considere substituir MessageBox.ShowConsole.WriteLine ou acrescentar a mensagem a uma multilinha TextBox.

Para executar o código de exemplo, cole-o em um projeto que contém uma instância do tipo UserControl chamada UserControl1. Em seguida, verifique se o manipulador de eventos está associado ao Load evento.

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

Comentários

Você pode usar esse evento para executar tarefas como alocar recursos usados pelo controle .

Observação

Se o UserControl fizer parte de um formulário filho MDI, o Load evento ocorrerá sempre que o formulário filho for mostrado. Nesse caso, você deve colocar qualquer código de inicialização única no UserControl em vez de um Load manipulador de eventos.

Cuidado

O Load evento ocorre quando o identificador do UserControl é criado. Em algumas circunstâncias, isso pode fazer com que o Load evento ocorra mais de uma vez. Por exemplo, o Load evento ocorre quando o UserControl é carregado e novamente se o identificador é recriado. (Uma maneira de recriar um identificador é chamando o RecreateHandle método .) Para considerar o Load evento que ocorre mais de uma vez, você deve colocar qualquer código de inicialização única no UserControl construtor em vez de um Load manipulador de eventos. Além disso, você não deve adicionar associações de dados ao UserControl em um Load manipulador de eventos.

Para obter mais informações sobre como lidar com eventos, consulte Manipulando e levantando eventos.

Aplica-se a

Confira também