BindingSource.AddingNew Evento
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Ocorre antes de um item ser adicionado à lista subjacente.
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 seguinte utiliza um BindingSource componente para associar uma lista a um DataGridView controlo. Novos itens são adicionados à lista pelo AddingNew gestor 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
Observações
O AddingNew evento ocorre antes de um novo objeto ser adicionado à lista subjacente representada pela List propriedade. Este evento é ativado após o AddNew método ser chamado, mas antes de o novo item ser criado e adicionado à lista subjacente. Ao lidar com este evento, o programador pode fornecer um comportamento personalizado de criação e inserção de itens sem ser forçado a derivar da BindingSource classe. Isto é conseguido no gestor de eventos ao definir 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 do tipo contido na lista, caso contrário ocorrerá uma exceção. Não podes definir a NewObject propriedade quando estás ligado a um DataView ou DataTable porque não podes adicionar um novo DataRowView à lista.
Para mais informações sobre como fornecer funcionalidades personalizadas para novos artigos, consulte o AddNew método. Para obter mais informações sobre como manipular eventos, consulte Manipulando e gerando eventos.