ICancelAddNew ICancelAddNew ICancelAddNew ICancelAddNew Interface

Définition

Ajoute la fonction transactionnelle lors de l'ajout d'un nouvel élément à une collection.Adds transactional capability when adding a new item to a collection.

public interface class ICancelAddNew
public interface ICancelAddNew
type ICancelAddNew = interface
Public Interface ICancelAddNew
Dérivé

Remarques

Le ICancelAddNew interface permet à une collection ajouter un nouvel élément d’une manière extensible.The ICancelAddNew interface enables a collection to add a new item in an extensible way. Le nouvel élément peut ensuite être validé ou restauré.The new item subsequently can be committed or rolled back. Le AddNew méthode de la collection est utilisée pour ajouter provisoirement l’élément qui est traité par la suite via les opérations suivantes :The AddNew method of the collection is used to tentatively add the item, which is subsequently transacted through the following operations:

  • Le EndNew méthode sera validée explicitement l’ajout en attente.The EndNew method will explicitly commit the pending addition.

  • Une autre opération collection, tel qu’un insertion, suppression ou déplacement validera implicitement l’ajout en attente.Performing another collection operation, such as an insertion, removal, or move will implicitly commit the pending addition.

  • Le CancelNew méthode restaurera l’ajout en attente si elle n’a pas déjà été validée.The CancelNew method will roll back the pending addition if it has not already been committed.

Notes

Dans certains scénarios, par exemple de liaison de données complexe Windows Forms, la collection peut recevoir CancelNew ou EndNew appelle d’autres éléments que l’élément qui vient d’être ajouté.In some scenarios, such as Windows Forms complex data binding, the collection may receive CancelNew or EndNew calls for items other than the newly added item. (Chaque élément est généralement une ligne dans une vue de données). Ignorer ces appels ; Annuler ou valider le nouvel élément uniquement lorsque l’index de cet élément est spécifié.(Each item is typically a row in a data view.) Ignore these calls; cancel or commit the new item only when that item's index is specified.

Il existe deux modèles qui autorisent l’addition transactionnelle d’un élément à une collection liée aux données :There are two models that allow transactional addition of an item to a data-bound collection:

Méthodes

CancelNew(Int32) CancelNew(Int32) CancelNew(Int32) CancelNew(Int32)

Élimine un nouvel élément en attente de la collection.Discards a pending new item from the collection.

EndNew(Int32) EndNew(Int32) EndNew(Int32) EndNew(Int32)

Valide un nouvel élément en attente dans la collection.Commits a pending new item to the collection.

S’applique à

Voir aussi