BindingSource.AddingNew Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.
