CurrencyManager.AddNew Méthode

Définition

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

public:
 override void AddNew();
public override void AddNew ();
override this.AddNew : unit -> unit
Public Overrides Sub AddNew ()

Exceptions

La source de données sous-jacente n'implémente pas IBindingList, ou la source de données a levé une exception car l'utilisateur a tenté d'ajouter une ligne à un DataView en lecture seule ou de taille fixe.The underlying data source does not implement IBindingList, or the data source has thrown an exception because the user has attempted to add a row to a read-only or fixed-size DataView.

Exemples

L’exemple de code suivant ajoute un nouvel élément à la liste avec la méthode AddNew.The following code example adds a new item to the list with the AddNew method.

void AddListItem()
{
   
   // Get the CurrencyManager for a DataTable.
   CurrencyManager^ myCurrencyManager = dynamic_cast<CurrencyManager^>(this->BindingContext[ DataTable1 ]);
   myCurrencyManager->AddNew();
}

private void AddListItem()
{
   // Get the CurrencyManager for a DataTable.
   CurrencyManager myCurrencyManager = 
   (CurrencyManager)this.BindingContext[DataTable1];
   myCurrencyManager.AddNew();
}
      
Private Sub AddListItem()
    ' Get the CurrencyManager for a DataTable.
    Dim myCurrencyManager As CurrencyManager = _ 
        CType(Me.BindingContext(DataTable1), CurrencyManager)
    myCurrencyManager.AddNew()
End Sub

Remarques

Cette méthode est prise en charge uniquement si la source de données implémente l’interface IBindingList et que la source de données autorise l’ajout de lignes (AllowNew est true).This method is supported only if the data source implements the IBindingList interface and the data source allows adding rows (AllowNew is true).

Notes

Cette propriété a été conçue pour permettre des contrôles à liaison complexe, tels que le contrôle DataGrid, pour ajouter de nouveaux éléments à la liste.This property was designed to allow complex-bound controls, such as the DataGrid control, to add new items to list.

En général, vous utilisez cette propriété uniquement si vous créez votre propre contrôle qui incorpore l' CurrencyManager.You typically use this property only if you are creating your own control that incorporates the CurrencyManager. Sinon, pour ajouter des éléments si la source de données est un DataView, utilisez la méthode DataView.AddNew de la classe DataView.Otherwise, to add items if the data source is a DataView, use the DataView.AddNew method of the DataView class. Si la source de données est un DataTable, utilisez la méthode NewRow et ajoutez la ligne au DataRowCollection.If the data source is a DataTable, use the NewRow method and add the row to the DataRowCollection.

S’applique à

Voir aussi