AddingNewEventArgs Classe

Definição

public ref class AddingNewEventArgs : EventArgs

public class AddingNewEventArgs : EventArgs

type AddingNewEventArgs = class
    inherit EventArgs

Public Class AddingNewEventArgs
Inherits EventArgs

Herança

Object

EventArgs

AddingNewEventArgs

Exemplos

O exemplo de código seguinte demonstra como usar a AddingNewEventArgs classe 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

A AddingNewEventArgs classe fornece dados para o BindingSource.AddingNew evento, que sinalizam que um item está prestes a ser adicionado a uma coleção. O evento dá ao programador, dentro do gestor AddingNewEventHandlerde eventos, a opção de fornecer o novo objeto ao definir a NewObject propriedade para este novo item. Se esta propriedade não estiver definida, a coleção normalmente usará o construtor sem parâmetros do tipo apropriado para construir um novo item. Em qualquer dos casos, o novo item será adicionado à coleção.

Se a coleção também implementar a ICancelAddNew interface, o item será adicionado provisoriamente, aguardando um commit ou rollback subsequente.

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>.

Para mais informações sobre como gerir eventos, consulte Gestão e Levantamento de Eventos.

Ver também

• AddingNewEventHandler
• AddingNew
• ICancelAddNew