BindingSource.AddingNew BindingSource.AddingNew BindingSource.AddingNew BindingSource.AddingNew Event

Definición

Se produce antes de que se agregue un elemento a la lista subyacente.Occurs before an item is added to the underlying list.

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

Excepciones

NewObject no es el mismo tipo que el tipo contenido en la lista.NewObject is not the same type as the type contained in the list.

Ejemplos

El siguiente ejemplo de código utiliza un BindingSource componente para enlazar una lista a un DataGridView control.The following code example uses a BindingSource component to bind a list to a DataGridView control. Se agregan nuevos elementos a la lista por el AddingNew controlador de eventos.New items are added to the list by the AddingNew event handler. Este ejemplo de código forma parte de un ejemplo más extenso incluido en Cómo: Personalizar elemento con el componente BindingSource de Windows Forms.This code example is part of a larger example provided in 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 agrega un nuevo objeto a la lista subyacente representada por la List propiedad.The AddingNew event occurs before a new object is added to the underlying list represented by the List property. Este evento se desencadena después de la AddNew método se llama, pero antes de que el nuevo elemento se crea y se agrega a la lista subyacente.This event is fired after the AddNew method is called, but before the new item is created and added to the underlying list. Al controlar este evento, el programador puede ofrecer la creación de elementos personalizada y el comportamiento de inserción sin estar obligado a derivar de la BindingSource clase.By handling this event, the programmer can provide custom item creation and insertion behavior without being forced to derive from the BindingSource class. Esto se realiza en el controlador de eventos estableciendo la NewObject propiedad de la System.ComponentModel.AddingNewEventArgs parámetro para el nuevo elemento.This is accomplished in the event handler by setting the NewObject property of the System.ComponentModel.AddingNewEventArgs parameter to the new item. 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.The new object created in the AddingNew event must be of the same type as the type contained in the list or an exception will occur. No puede establecer el NewObject propiedad cuando se enlaza a un DataView o DataTable porque no se puede agregar un nuevo DataRowView a la lista.You cannot set the NewObject property when bound to a DataView or DataTable because you cannot add a new DataRowView to the list.

Para obtener más información sobre cómo proporcionar la funcionalidad personalizada de nuevos elementos, vea el AddNew método.For more information about supplying custom new item functionality, see the AddNew method. Para obtener más información sobre el manejo de eventos, consulte controlar y provocar eventos.For more information about handling events, see Handling and Raising Events.

Se aplica a

Consulte también: