AddingNewEventHandler Délégué

Définition

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

public delegate void AddingNewEventHandler(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)

Paramètres

Exemples

L’exemple de code suivant montre comment utiliser le AddingNewEventHandler délégué pour gérer l’événement BindingSource.AddingNew . Cet exemple de code fait partie d’un exemple plus large fourni dans 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

Remarques

L’événement BindingSource.AddingNew se produit avant d’ajouter un nouvel élément à une collection, généralement dans les scénarios de liaison de données. Le gestionnaire de cet événement peut fournir le nouvel élément à ajouter, en remplaçant l’action standard de la classe de collection. Pour ce faire, définissez la NewObject propriété du AddingNewEventArgs paramètre e sur ce nouvel élément. En règle générale, cet élément doit être d’un type attendu par la collection de destinataires, ou la collection lève une exception de type InvalidCastException.

Cet événement est couramment utilisé dans les scénarios de liaison de données, au sein de classes telles que System.Windows.Forms.BindingSource et System.ComponentModel.BindingList<T>.

Lorsque vous créez un AddingNewEventHandler délégué, vous identifiez la méthode qui gère l’événement. Pour associer l’événement à votre gestionnaire d’événements, ajoutez une instance du délégué à l’événement. Le gestionnaire d’événements est appelé chaque fois que l’événement se produit, sauf si vous supprimez le délégué. Pour plus d’informations sur les délégués de gestionnaire d’événements, consultez Gestion et déclenchement d’événements.

Voir aussi

• AddingNewEventArgs
• BindingSource
• BindingList<T>