AddingNewEventHandler Delegado

Definición

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

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.The source of the event, typically a data container or data-bound collection.

e
AddingNewEventArgs

Valor 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 utilizar el delegado AddingNewEventHandler para controlar el evento de BindingSource.AddingNew.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 grande que se proporciona en Cómo: personalizar la adición de elementos con el Windows Forms BindingSource.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 evento BindingSource.AddingNew se produce 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 que se va a agregar, invalidando 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 logra estableciendo la propiedad NewObject del parámetro AddingNewEventArgs e en 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 producirá 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 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 controladores de eventos, vea controlar y provocar eventos.For more information about event-handler delegates, see Handling and Raising Events.

Métodos de extensión

GetMethodInfo(Delegate)

Obtiene un objeto que representa el método representado por el delegado especificado.Gets an object that represents the method represented by the specified delegate.

Se aplica a

Consulte también: