AddingNewEventHandler Delegar

Definição

public delegate void AddingNewEventHandler(System::Object ^ sender, AddingNewEventArgs ^ e);

public delegate void AddingNewEventHandler(object sender, AddingNewEventArgs e);

type AddingNewEventHandler = delegate of obj * AddingNewEventArgs -> unit

Public Delegate Sub AddingNewEventHandler(sender As Object, e As AddingNewEventArgs)

Parâmetros

Exemplos

O exemplo de código seguinte demonstra como usar o AddingNewEventHandler delegado para gerir o BindingSource.AddingNew evento. Este exemplo de código faz parte de um exemplo maior fornecido em How to: Customize Item Addition with the Windows Forms BindingSource.

// This event handler provides custom item-creation behavior.
void OnCustomersBindingSourceAddingNew(Object^ sender, 
    AddingNewEventArgs^ e)
{
    e->NewObject = DemoCustomer::CreateNewCustomer();
}

// This event handler provides custom item-creation behavior.
void customersBindingSource_AddingNew(
    object sender, 
    AddingNewEventArgs e)
{
    e.NewObject = DemoCustomer.CreateNewCustomer();
}

' This event handler provides custom item-creation behavior.
 Private Sub customersBindingSource_AddingNew( _
 ByVal sender As Object, _
 ByVal e As AddingNewEventArgs) _
 Handles customersBindingSource.AddingNew

     e.NewObject = DemoCustomer.CreateNewCustomer()

 End Sub

Observações

O BindingSource.AddingNew evento ocorre antes de adicionar um novo item a uma coleção, tipicamente em cenários de ligação de dados. O responsável deste evento pode fornecer o novo item a ser adicionado, sobrepondo a ação padrão da classe de coleção. Isto é conseguido definindo a NewObject propriedade do AddingNewEventArgs parâmetro e para este novo item. Normalmente, este item deve ser do tipo esperado pela coleção destinatária, caso contrário a coleção lançará uma exceção do tipo InvalidCastException.

Este evento é frequentemente utilizado em cenários de ligação de dados, dentro de classes como System.Windows.Forms.BindingSource e System.ComponentModel.BindingList<T>.

Quando cria um AddingNewEventHandler delegado, identifica o método que irá gerir o evento. Para associar o evento ao seu gestor de eventos, adicione uma instância do delegado ao evento. O gestor de eventos é chamado sempre que o evento ocorre, a menos que remova o delegado. Para mais informações sobre os delegados handlers de eventos, consulte Gestão e Angariação de Eventos.

Ver também

• AddingNewEventArgs
• BindingSource
• BindingList<T>