BindingSource.AddNew BindingSource.AddNew BindingSource.AddNew BindingSource.AddNew Method

Définition

Ajoute un nouvel élément à la liste sous-jacente.Adds a new item to the underlying list.

public:
 virtual System::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.The Object that was created and added to the list.

Implémente

Exceptions

La propriété AllowNew a la valeur false.The AllowNew property is set to false.

- ou --or- Aucun constructeur public sans paramètre n’a pu être trouvé pour le type d’élément actif.A public parameterless constructor could not be found for the current item type.

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.

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 List par la propriété.The AddNew method adds a new item to the underlying list represented by the List property. Cette méthode Configure la série d’actions suivante:This method sets up the following series of actions:

  1. La EndEdit méthode est appelée automatiquement pour valider toutes les opérations de modification en attente.The EndEdit method is automatically called to commit any pending edit operations.

  2. L' AddingNew événement est déclenché automatiquement.The AddingNew event is automatically raised. Cet événement peut être géré par programmation pour construire le nouvel élément.This event can be programmatically handled to construct the new item. 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.

    Si l' AddingNew événement n’est pas géré et que la liste sous- IBindingListjacente est un, la demande est transmise à IBindingList.AddNew la méthode de la liste.If the AddingNew event is not handled, and the underlying list is an IBindingList, then the request is passed to the list's IBindingList.AddNew method. Si la liste sous-jacente n' IBindingListest pas un, l’élément est créé automatiquement via son constructeur sans paramètre public.If the underlying list is not an IBindingList, the item is automatically created through its public parameterless constructor. Dans les deux cas, le nouvel élément est ajouté à la fin de la liste.In either case, the new item is added to the end of the list.

  3. Le nouvel élément est ajouté immédiatement à la liste interne, sauf si la source de données IEditableObject implémente l’interface.The new item is added immediately to the internal list unless the data source implements the IEditableObject interface. Dans ce cas, le nouvel élément n’est pas validé jusqu’à ce qu' ICancelAddNew.EndNew un appel explicite à soit effectué ou jusqu’à ce qu’une nouvelle opération de liste soit initiée.In this case, the new item is not committed until an explicit call to ICancelAddNew.EndNew is made or until a new list operation is initiated. Avant qu’elle ne soit validée, le nouvel élément peut être restauré en CancelEditappelant, auquel cas le nouvel élément est ignoré.Before it is committed, the new item can be rolled back by calling CancelEdit, in which case the new item is discarded.

Cette méthode déclenche l' ListChanged événement.This method raises the ListChanged event.

S’applique à

Voir aussi