AddingNewEventHandler Delegate

Definición

Representa el método que controlará el evento AddingNew. Represents the method that will handle the AddingNew event.

public delegate void AddingNewEventHandler(object sender, AddingNewEventArgs e);
Parámetros
sender

Origen del evento, normalmente un contenedor de datos o una colección enlazada a datos. The source of the event, typically a data container or data-bound collection.

e

Objeto AddingNewEventArgs que contiene los datos del evento. A AddingNewEventArgs that contains the event data.

Herencia
AddingNewEventHandler

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el AddingNewEventHandler delegado para controlar el BindingSource.AddingNew eventos.The following code example demonstrates how to use the AddingNewEventHandler delegate to handle the BindingSource.AddingNew event. Este ejemplo de código forma parte de un ejemplo más extenso incluido en Cómo: personalizar la inclusión de elementos 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 BindingSource.AddingNew evento tiene lugar antes de agregar un nuevo elemento a una colección, normalmente en escenarios de enlace de datos.The BindingSource.AddingNew event occurs prior to adding a new item to a collection, typically in data-binding scenarios. El controlador de este evento puede proporcionar el nuevo elemento para agregar, reemplazar la acción estándar de la clase de colección.The handler of this event can supply the new item to be added, overriding the standard action of the collection class. Esto se consigue estableciendo la NewObject propiedad de la AddingNewEventArgs parámetro e a este nuevo elemento.This is accomplished by setting the NewObject property of the AddingNewEventArgs parameter e to this new item. Normalmente, este elemento debe ser de un tipo esperado por la colección de destinatarios o la colección iniciará una excepción de tipo InvalidCastException.Typically this item must be of a type expected by the recipient collection, or the collection will throw an exception of type InvalidCastException.

Este evento se utiliza normalmente en escenarios de enlace de datos, dentro de las clases como System.Windows.Forms.BindingSource y System.ComponentModel.BindingList<T>.This event is commonly used in data-binding scenarios, within classes such as System.Windows.Forms.BindingSource and System.ComponentModel.BindingList<T>.

Cuando se crea un delegado AddingNewEventHandler, se identifica el método que controlará el evento.When you create an AddingNewEventHandler delegate, you identify the method that will handle the event. Para asociar el evento al controlador, se debe agregar una instancia del delegado al evento.To associate the event with your event handler, add an instance of the delegate to the event. Siempre que se produce el evento, se llama a su controlador, a menos que se quite el delegado.The event handler is called whenever the event occurs, unless you remove the delegate. Para obtener más información sobre los delegados de controlador de eventos, consulte controlar y provocar eventos.For more information about event-handler delegates, see Handling and Raising Events.

Se aplica a

Consultar también