BindingSource.AddingNew BindingSource.AddingNew BindingSource.AddingNew BindingSource.AddingNew Event

Définition

Se produit avant l'ajout d'un élément à la liste sous-jacente.Occurs before an item is added to the underlying list.

public:
 event System::ComponentModel::AddingNewEventHandler ^ AddingNew;
public event System.ComponentModel.AddingNewEventHandler AddingNew;
member this.AddingNew : System.ComponentModel.AddingNewEventHandler 
Public Custom Event AddingNew As AddingNewEventHandler 

Exceptions

NewObject n'est pas le même type que le type contenu dans la liste.NewObject is not the same type as the type contained in the list.

Exemples

L’exemple de code suivant utilise BindingSource un composant pour lier une liste à DataGridView un contrôle.The following code example uses a BindingSource component to bind a list to a DataGridView control. Les nouveaux éléments sont ajoutés à la liste par AddingNew le gestionnaire d’événements.New items are added to the list by the AddingNew event handler. 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' AddingNew événement se produit avant l’ajout d’un nouvel objet à la liste sous- List jacente représentée par la propriété.The AddingNew event occurs before a new object is added to the underlying list represented by the List property. Cet événement est déclenché après l' AddNew appel de la méthode, mais avant la création et l’ajout du nouvel élément à la liste sous-jacente.This event is fired after the AddNew method is called, but before the new item is created and added to the underlying list. En gérant cet événement, le programmeur peut fournir un comportement de création et d’insertion d’éléments personnalisés sans être BindingSource obligé de dériver de la classe.By handling this event, the programmer can provide custom item creation and insertion behavior without being forced to derive from the BindingSource class. Pour ce faire, dans le gestionnaire d’événements, NewObject affectez à System.ComponentModel.AddingNewEventArgs la propriété du paramètre le nouvel élément.This is accomplished in the event handler by setting the NewObject property of the System.ComponentModel.AddingNewEventArgs parameter to the new item. Le nouvel objet créé dans l' AddingNew événement doit être du même type que le type contenu dans la liste ou une exception se produit.The new object created in the AddingNew event must be of the same type as the type contained in the list or an exception will occur. Vous ne pouvez pas NewObject définir la propriété lorsqu’elle DataView est DataTable liée à un ou parce que DataRowView vous ne pouvez pas ajouter un nouveau à la liste.You cannot set the NewObject property when bound to a DataView or DataTable because you cannot add a new DataRowView to the list.

Pour plus d’informations sur la fourniture de nouvelles fonctionnalités personnalisées d' AddNew éléments, consultez la méthode.For more information about supplying custom new item functionality, see the AddNew method. Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.For more information about handling events, see Handling and Raising Events.

S’applique à

Voir aussi