AddingNewEventHandler Délégué

Définition

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

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

e
AddingNewEventArgs

AddingNewEventArgs qui contient les données d'événement.A AddingNewEventArgs that contains the event data.

Héritage
AddingNewEventHandler

Exemples

L’exemple de code suivant montre comment utiliser le AddingNewEventHandler délégué pour gérer l' BindingSource.AddingNew événement.The following code example demonstrates how to use the AddingNewEventHandler delegate to handle the BindingSource.AddingNew event. Cet exemple de code fait partie d’un exemple plus complet fourni dans How to: Personnaliser l’ajout d’éléments avec leBindingSource Windows Forms.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

Remarques

L' BindingSource.AddingNew événement se produit avant l’ajout d’un nouvel élément à une collection, en général dans les scénarios de liaison de données.The BindingSource.AddingNew event occurs prior to adding a new item to a collection, typically in data-binding scenarios. Le gestionnaire de cet événement peut fournir le nouvel élément à ajouter, en substituant l’action standard de la classe de collection.The handler of this event can supply the new item to be added, overriding the standard action of the collection class. Pour ce faire, affectez NewObject la valeur à AddingNewEventArgs la e propriété du paramètre le nouvel élément.This is accomplished by setting the NewObject property of the AddingNewEventArgs parameter e to this new item. En général, cet élément doit être d’un type attendu par la collection de destinataires, ou la collection lèvera une InvalidCastExceptionexception de type.Typically this item must be of a type expected by the recipient collection, or the collection will throw an exception of type InvalidCastException.

Cet événement est couramment utilisé dans les scénarios de liaison de données, dans les System.Windows.Forms.BindingSource classes System.ComponentModel.BindingList<T>telles que et.This event is commonly used in data-binding scenarios, within classes such as System.Windows.Forms.BindingSource and System.ComponentModel.BindingList<T>.

Lorsque vous créez un délégué AddingNewEventHandler, vous identifiez la méthode qui gérera l'événement.When you create an AddingNewEventHandler delegate, you identify the method that will handle the event. Pour associer l'événement au gestionnaire d'événements, ajoutez une instance du délégué à l'événement.To associate the event with your event handler, add an instance of the delegate to the event. Le gestionnaire d'événements est appelé chaque fois qu'un événement se produit, sauf si vous supprimez le délégué.The event handler is called whenever the event occurs, unless you remove the delegate. Pour plus d’informations sur les délégués de gestionnaires d’événements, consultez gestion et déclenchement d’événements.For more information about event-handler delegates, see Handling and Raising Events.

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é.Gets an object that represents the method represented by the specified delegate.

S’applique à

Voir aussi