Partager via

BindingSource.AddNew Méthode

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Source:
BindingSource.cs
Source:
BindingSource.cs
Source:
BindingSource.cs
Source:
BindingSource.cs
Source:
BindingSource.cs

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

Créé Object et ajouté à la liste.

Implémente

AddNew()

Exceptions

InvalidOperationException

La AllowNew propriété est définie sur false.

- ou -

Impossible de trouver un constructeur public sans paramètre pour le type d’élément actuel.

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 How to : Customize Item Addition with the 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 automatiquement appelée pour valider toutes les opérations de modification 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. 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 ou une exception se produit.

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