AddingNewEventHandler Délégué

Définition

Espace de noms:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Représente la méthode qui gérera l'événement 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)

Paramètres

sender

Object

Source de l’événement, en général un conteneur de données ou une collection liée aux données.

e

AddingNewEventArgs

AddingNewEventArgs qui contient les données d’événement.

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 Guide pratique pour personnaliser l’ajout d’éléments avec le 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 l’ajout d’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, sinon 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 délégué AddingNewEventHandler, vous identifiez la méthode qui gérera l'événement. Pour associer l'événement au gestionnaire d'événements, ajoutez une instance du délégué à l'événement. Le gestionnaire d'événements est appelé chaque fois qu'un événement se produit, sauf si vous supprimez le délégué. Pour plus d’informations sur les délégués du gestionnaire d’événements, consultez Gestion et levée d’événements.

Méthodes d’extension

GetMethodInfo(Delegate)

Obtient un objet qui représente la méthode représentée par le délégué spécifié.

Voir aussi

• AddingNewEventArgs
• BindingSource
• BindingList<T>