UserControl.Load Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.
