Exportar (0) Imprimir
Expandir todo
Expandir Minimizar
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

AddingNewEventHandler (Delegado)

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
Tipo: System.Object
Origen del evento, normalmente un contenedor de datos o una colección enlazada a datos.
e
Tipo: System.ComponentModel.AddingNewEventArgs
Objeto AddingNewEventArgs que contiene los datos del evento.

El evento BindingSource.AddingNew se produce antes de agregar un elemento nuevo a una colección, normalmente en escenarios de enlace de datos. El controlador de este evento puede suministrar el nuevo elemento que se va a agregar, con lo que se reemplazaría la acción estándar de la clase de colección. Para que esto ocurra, hay que establecer la propiedad NewObject del parámetro AddingNewEventArgs (e) en 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.

Normalmente, este evento se utiliza 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 al método que controlará el evento. Para asociar el evento al controlador de eventos, agregue al evento una instancia del delegado. A menos que se quite el delegado, el controlador de eventos recibirá una llamada siempre que se produzca el evento. Para obtener más información acerca de los delegados del controlador de eventos, vea Eventos y delegados.

NotaNota

El atributo HostProtectionAttribute aplicado a este tipo o miembro tiene el valor de propiedad Resources siguiente: SharedState. El atributo HostProtectionAttribute no afecta a las aplicaciones de escritorio (que normalmente se inician haciendo doble clic en un icono, escribiendo un comando o introduciendo una dirección URL en el explorador). Para obtener más información, vea la clase HostProtectionAttribute o Programación en SQL Server y atributos de protección de host.

En el ejemplo de código siguiente se muestra cómo utilizar el delegado AddingNewEventHandler para controlar el evento BindingSource.AddingNew. Este ejemplo de código forma parte de un ejemplo más extenso incluido 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

Compatible con: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft