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 de um item ser 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 é do mesmo tipo que o 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 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
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 manipular 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 para 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 uma nova 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 manipular eventos, consulte Manipulando e gerando eventos.
