Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Delegado AddingNewEventHandler

 

Publicado: octubre de 2016

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

Espacio de nombres:   System.ComponentModel
Ensamblado:  System (en System.dll)

[HostProtectionAttribute(SecurityAction.LinkDemand, SharedState = true)]
public delegate void AddingNewEventHandler(
	object sender,
	AddingNewEventArgs e
)

Parámetros

sender
Type: System.Object

El origen del evento, normalmente un contenedor de datos o colección enlazada a datos.

e
Type: System.ComponentModel.AddingNewEventArgs

Objeto AddingNewEventArgs que contiene los datos del evento.

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 suministrar el nuevo elemento para agregar, reemplazar la acción estándar de la clase de colección. Esto se logra estableciendo la NewObject propiedad de la AddingNewEventArgs parámetro e a este nuevo elemento. Normalmente este elemento debe ser del tipo esperado por la colección de destinatarios o la colección producirá una excepción de tipo 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>.

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 de controladores de eventos, vea NIB: delegados y eventos.

En el ejemplo de código siguiente se muestra cómo utilizar el AddingNewEventHandler delegado para controlar el BindingSource.AddingNew eventos. Este ejemplo de código forma parte de un ejemplo más extenso en Cómo: Personalizar la forma de agregar elementos con el control BindingSource de formularios Windows Forms.

// This event handler provides custom item-creation behavior.
void customersBindingSource_AddingNew(
    object sender, 
    AddingNewEventArgs e)
{
    e.NewObject = DemoCustomer.CreateNewCustomer();
}

.NET Framework
Disponible desde 2.0
Volver al principio
Mostrar: