BindingSource.AddNew, méthode

public virtual Object AddNew()

public Object AddNew()

public function AddNew() : Object

Implémentations

La méthode AddNew ajoute un nouvel élément à la liste sous-jacente représentée par la propriété List. Cette méthode configure les séries d'actions suivantes :

1. La méthode EndEdit est appelée automatiquement pour valider toutes les opérations d'édition en attente.

2. L'événement AddingNew est déclenché automatiquement. Cet événement peut être géré par programme pour construire le nouvel élément. Cette action est effectuée dans le gestionnaire d'événements en affectant la valeur du nouvel élément à la propriété NewObject du paramètre System.ComponentModel.AddingNewEventArgs. Le nouvel objet créé dans l'événement AddingNew doit être du même type que le type contenu dans la liste, sinon une exception se produira.

   Si l'événement AddingNew n'est pas géré et que la liste sous-jacente est IBindingList, la demande est passée à la méthode IBindingList.AddNew de la liste. Si la liste sous-jacente n'est pas IBindingList, l'élément est créé automatiquement via son constructeur public par défaut. Dans les deux cas, le nouvel élément est ajouté à la fin de la liste.

3. Le nouvel élément est ajouté immédiatement à la liste interne sauf si la source de données implémente l'interface IEditableObject. Dans ce cas, le nouvel élément n'est pas validé jusqu'à ce qu'un appel explicite à ICancelAddNew.EndNew soit fait ou qu'une nouvelle opération de liste soit initialisée. Avant sa validation, le nouvel élément peut être restauré en appelant CancelEdit, auquel cas le nouvel élément est ignoré.

Cette méthode déclenche l'événement ListChanged.

L'exemple suivant utilise un composant BindingSource pour lier une liste à un contrôle DataGridView. Les nouveaux éléments sont ajoutés à la liste par le gestionnaire d'événements AddingNew. Cet exemple de code fait partie d'un exemple plus développé fourni dans Comment : personnaliser l'ajout d'éléments avec le composant BindingSource Windows Forms.

private void Form1_Load(System.Object sender, System.EventArgs e)
{
    // Add a DemoCustomer to cause a row to be displayed.
    this.customersBindingSource.AddNew();

    // Bind the BindingSource to the DataGridView 
    // control's DataSource.
    this.customersDataGridView.DataSource = 
        this.customersBindingSource;
}

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile pour Smartphone, Windows Mobile pour Pocket PC

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

.NET Compact Framework

Référence