AddingNewEventHandler Delegar

Definição

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Representa o método que manipulará o evento de AddingNew .

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

sender

Object

A origem do evento, normalmente um contêiner de dados ou uma coleção associada a dados.

e

AddingNewEventArgs

Um AddingNewEventArgs que contém os dados do evento.

Exemplos

O exemplo de código a seguir demonstra como usar o AddingNewEventHandler delegado para manipular o BindingSource.AddingNew evento. Este exemplo de código faz parte de um exemplo maior fornecido em Como personalizar a adição de item com o 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

Comentários

O BindingSource.AddingNew evento ocorre antes de adicionar um novo item a uma coleção, normalmente em cenários de associação de dados. O manipulador desse evento pode fornecer o novo item a ser adicionado, substituindo a ação padrão da classe de coleção. Isso é feito definindo a NewObject propriedade do AddingNewEventArgs parâmetro e para este novo item. Normalmente, esse item deve ser de um tipo esperado pela coleção de destinatários ou a coleção gerará uma exceção do tipo InvalidCastException.

Esse evento é comumente usado em cenários de associação de dados, dentro de classes como System.Windows.Forms.BindingSource e System.ComponentModel.BindingList<T>.

Ao criar um AddingNewEventHandler delegado, você identifica o método que manipulará o evento. Para associar o evento ao manipulador de eventos, adicione uma instância do delegado ao evento. O manipulador de eventos é chamado sempre que o evento ocorre, a menos que você remova o representante. Para obter mais informações sobre delegados do manipulador de eventos, consulte Manipulando e levantando eventos.

Métodos de Extensão

GetMethodInfo(Delegate)

Obtém um objeto que representa o método representado pelo delegado especificado.

Confira também

• AddingNewEventArgs
• BindingSource
• BindingList<T>