BindingSource.AddingNew Evento

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Se produce antes de que se agregue un elemento a la lista subyacente.

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

AddingNewEventHandler

Excepciones

InvalidOperationException

NewObject no es el mismo tipo que el tipo contenido en la lista.

Ejemplos

En el ejemplo de código siguiente se usa un BindingSource componente para enlazar una lista a un DataGridView control . El controlador de eventos agrega nuevos elementos a la lista AddingNew . Este ejemplo de código forma parte de un ejemplo más grande proporcionado en 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

Comentarios

El AddingNew evento se produce antes de que se agregue un nuevo objeto a la lista subyacente representada por la List propiedad . Este evento se desencadena después de llamar al AddNew método , pero antes de que se cree el nuevo elemento y se agregue a la lista subyacente. Al controlar este evento, el programador puede proporcionar un comportamiento de inserción y creación de elementos personalizados sin que se obligue a derivar de la BindingSource clase . Esto se logra en el controlador de eventos estableciendo la NewObject propiedad del System.ComponentModel.AddingNewEventArgs parámetro en el nuevo elemento. El nuevo objeto creado en el AddingNew evento debe ser del mismo tipo que el tipo contenido en la lista o se producirá una excepción. No se puede establecer la NewObject propiedad cuando está enlazada a o DataViewDataTable porque no se puede agregar una nueva DataRowView a la lista.

Para obtener más información sobre cómo proporcionar una nueva funcionalidad de elemento personalizada, vea el AddNew método . Para obtener más información sobre el manejo de eventos, consulte controlar y provocar eventos.

Consulte también

• AddNew()
• OnAddingNew(AddingNewEventArgs)
• AddingNewEventArgs