BindingSource.AddingNew Evento
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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;public event System.ComponentModel.AddingNewEventHandler? AddingNew;member this.AddingNew : System.ComponentModel.AddingNewEventHandler Public Custom Event AddingNew As AddingNewEventHandler Tipo de evento
Excepciones
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.
