UserControl.Load Evento
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Ocorre antes de o controlo se tornar 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 seguinte exemplo de código demonstra a utilização deste elemento. No exemplo, um gestor de eventos reporta a ocorrência do Load evento. Este relatório ajuda-o a saber quando o evento ocorre e pode ajudá-lo na depuração. Para reportar múltiplos eventos ou eventos que ocorrem frequentemente, considere substituir MessageBox.Show ou Console.WriteLine anexar a mensagem a uma multilinha TextBox.
Para executar o código de exemplo, cole-o num projeto que contenha uma instância do tipo UserControl chamada UserControl1. Depois, certifique-se de que o gestor 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
Observações
Pode usar este evento para realizar tarefas como a alocação de recursos usados pelo controlo.
Note
Se for UserControl parte de uma forma MDI filha, o Load evento ocorrerá cada vez que a forma filha for mostrada. Neste caso, deve colocar qualquer código de inicialização de uma única utilização no UserControl gestor de eventos em vez de um Load evento.
Atenção
O Load evento ocorre quando a alavanca para o UserControl é criada. Em algumas circunstâncias, isto pode fazer com que o Load evento aconteça mais do que uma vez. Por exemplo, o Load evento ocorre quando o UserControl é carregado, e novamente se o handle for recriado. (Uma forma de recriar um handle é chamando o RecreateHandle método.) Para ter em conta que o Load evento ocorreu mais do que uma vez, deve colocar qualquer código de inicialização de uma só vez no UserControl construtor em vez de um Load gestor de eventos. Além disso, não deve adicionar ligações de dados ao UserControl handler de in a Load event.
Para obter mais informações sobre como manipular eventos, consulte Manipulando e gerando eventos.
