AddingNewEventArgs Classe

Définition

public ref class AddingNewEventArgs : EventArgs

public class AddingNewEventArgs : EventArgs

type AddingNewEventArgs = class
    inherit EventArgs

Public Class AddingNewEventArgs
Inherits EventArgs

Héritage

Object

EventArgs

AddingNewEventArgs

Exemples

L’exemple de code suivant montre comment utiliser la AddingNewEventArgs classe 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

La AddingNewEventArgs classe fournit des données pour l’événement BindingSource.AddingNew , ce qui signale qu’un élément est sur le point d’être ajouté à une collection. L’événement donne au programmeur, dans le gestionnaire AddingNewEventHandlerd’événements, l’option de fournir le nouvel objet en définissant la NewObject propriété sur ce nouvel élément. Si cette propriété n’est pas définie, la collection utilise généralement le constructeur sans paramètre du type approprié pour construire un nouvel élément. Dans les deux cas, le nouvel élément sera ajouté à la collection.

Si la collection implémente également l’interface ICancelAddNew , l’élément est ajouté provisoirement, en attendant une validation ou restauration ultérieure.

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>.

Pour plus d’informations sur la gestion des événements, consultez Gestion et déclenchement d’événements.

Voir aussi

• AddingNewEventHandler
• AddingNew
• ICancelAddNew