AddingNewEventHandler Delegado

Definición

Espacio de nombres:

System.ComponentModel

Ensamblado:

System.ComponentModel.TypeConverter.dll

Representa el método que controlará el evento AddingNew.

public delegate void AddingNewEventHandler(System::Object ^ sender, AddingNewEventArgs ^ e);

public delegate void AddingNewEventHandler(object? sender, AddingNewEventArgs e);

type AddingNewEventHandler = delegate of obj * AddingNewEventArgs -> unit

Public Delegate Sub AddingNewEventHandler(sender As Object, e As AddingNewEventArgs)

Parámetros

sender

Object

Origen del evento, normalmente un contenedor de datos o una colección enlazada a datos.

e

AddingNewEventArgs

AddingNewEventArgs que contiene los datos del evento.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el AddingNewEventHandler delegado para controlar el BindingSource.AddingNew evento. 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 BindingSource.AddingNew evento se produce antes de agregar un nuevo elemento a una colección, normalmente en escenarios de enlace de datos. El controlador de este evento puede proporcionar el nuevo elemento que se va a agregar, reemplazando la acción estándar de la clase de colección. Esto se logra estableciendo la NewObject propiedad del AddingNewEventArgs parámetro e en este nuevo elemento. Normalmente, este elemento debe ser de un tipo esperado por la colección de destinatarios o la colección producirá una excepción de tipo InvalidCastException.

Este evento se usa normalmente en escenarios de enlace de datos, dentro de clases como System.Windows.Forms.BindingSource y System.ComponentModel.BindingList<T>.

Cuando se crea un delegado AddingNewEventHandler, se identifica el método que controlará el evento. Para asociar el evento al controlador, se debe agregar una instancia del delegado al evento. Siempre que se produce el evento, se llama a su controlador, a menos que se quite el delegado. Para obtener más información sobre los delegados del controlador de eventos, consulte Control y generación de eventos.

Métodos de extensión

GetMethodInfo(Delegate)

Obtiene un objeto que representa el método representado por el delegado especificado.

Consulte también

• AddingNewEventArgs
• BindingSource
• BindingList<T>