Compartilhar via


BindingSource.AddingNew Evento

Definição

Ocorre antes que um item seja adicionado à lista subjacente.

public:
 event System::ComponentModel::AddingNewEventHandler ^ AddingNew;
public event System.ComponentModel.AddingNewEventHandler AddingNew;
public event System.ComponentModel.AddingNewEventHandler? AddingNew;
member this.AddingNew : System.ComponentModel.AddingNewEventHandler 
Public Custom Event AddingNew As AddingNewEventHandler 

Tipo de evento

Exceções

NewObject não é igual ao tipo contido na lista.

Exemplos

O exemplo de código a seguir usa um BindingSource componente para associar uma lista a um DataGridView controle. Novos itens são adicionados à lista pelo AddingNew manipulador de eventos. 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 AddingNew evento ocorre antes de um novo objeto ser adicionado à lista subjacente representada pela List propriedade . Esse evento é acionado depois que o AddNew método é chamado, mas antes que o novo item seja criado e adicionado à lista subjacente. Ao lidar com esse evento, o programador pode fornecer um comportamento personalizado de criação e inserção de item sem ser forçado a derivar da BindingSource classe . Isso é feito no manipulador de eventos definindo a NewObject propriedade do System.ComponentModel.AddingNewEventArgs parâmetro como o novo item. O novo objeto criado no AddingNew evento deve ser do mesmo tipo que o tipo contido na lista ou ocorrerá uma exceção. Não é possível definir a NewObject propriedade quando associada a um DataView ou DataTable porque não é possível adicionar um novo DataRowView à lista.

Para obter mais informações sobre como fornecer a funcionalidade personalizada de novo item, consulte o AddNew método . Para obter mais informações sobre como lidar com eventos, consulte Manipulando e levantando eventos.

Aplica-se a

Confira também