BindingSource.AddNew Méthode

Définition

Ajoute un nouvel élément à la liste sous-jacente.

public:
 virtual System::Object ^ AddNew();
public virtual object AddNew ();
public virtual object? AddNew ();
abstract member AddNew : unit -> obj
override this.AddNew : unit -> obj
Public Overridable Function AddNew () As Object

Retours

Object qui a été créé et ajouté à la liste.

Implémente

Exceptions

La propriété AllowNew a la valeur false.

- ou -

Aucun constructeur public sans paramètre n’a pu être trouvé pour le type d’élément actif.

Exemples

L’exemple de code suivant utilise un BindingSource composant pour lier une liste à un DataGridView contrôle. 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 large fourni dans Guide pratique pour personnaliser l’ajout d’éléments avec le Windows Forms BindingSource.

private:
   
    void OnMainFormLoad(Object^ sender, 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;
    }
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;
}
Private Sub Form1_Load( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs)

    ' Add a DemoCustomer to cause a row to be displayed.
    Me.customersBindingSource.AddNew()

    ' Bind the BindingSource to the DataGridView 
    ' control's DataSource.
    Me.customersDataGridView.DataSource = Me.customersBindingSource

End Sub

Remarques

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

  1. La EndEdit méthode est appelée automatiquement pour valider toutes les opérations de modification en attente.

  2. L’événement AddingNew est automatiquement déclenché. Cet événement peut être géré par programmation pour construire le nouvel élément. Pour ce faire, dans le gestionnaire d’événements, définissez la NewObject propriété du System.ComponentModel.AddingNewEventArgs paramètre sur le nouvel élément. 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 produit.

    Si l’événement AddingNew n’est pas géré et que la liste sous-jacente est un IBindingList, la demande est passée à la méthode de IBindingList.AddNew la liste. Si la liste sous-jacente n’est pas un IBindingList, l’élément est automatiquement créé via son constructeur public sans paramètre. 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ée tant qu’un appel explicite à ICancelAddNew.EndNew n’est pas effectué ou qu’une nouvelle opération de liste n’est pas lancé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 .

S’applique à

Voir aussi