Partage via


ICancelAddNew Interface

Définition

Ajoute la fonction transactionnelle lors de l'ajout d'un nouvel élément à une collection.

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

Remarques

L’interface ICancelAddNew permet à une collection d’ajouter un nouvel élément de manière extensible. Le nouvel élément peut ensuite être validée ou restaurée. La AddNew méthode de la collection est utilisée pour ajouter provisoirement l’élément, qui est ensuite traité via les opérations suivantes :

  • La EndNew méthode valide explicitement l’ajout en attente.

  • L’exécution d’une autre opération de collection, telle qu’une insertion, une suppression ou un déplacement, valide implicitement l’ajout en attente.

  • La CancelNew méthode restaure l’ajout en attente s’il n’a pas déjà été validée.

Notes

Dans certains scénarios, tels que Windows Forms liaison de données complexes, la collection peut recevoir CancelNew ou EndNew appeler des éléments autres que l’élément nouvellement ajouté. (Chaque élément est généralement une ligne dans une vue de données.) Ignorez ces appels ; annuler ou valider le nouvel élément uniquement lorsque l’index de cet élément est spécifié.

Il existe deux modèles qui autorisent l’ajout transactionnel d’un élément à une collection liée aux données :

Méthodes

CancelNew(Int32)

Élimine un nouvel élément en attente de la collection.

EndNew(Int32)

Valide un nouvel élément en attente dans la collection.

S’applique à

Voir aussi