ICancelAddNew Interface

Définition

Espace de noms:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

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é

System.ComponentModel.BindingList<T>

System.Windows.Forms.BindingSource

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 :

• L’ancien modèle s’appuie directement sur une collection qui implémente l’interface IBindingList et est lié aux données directement à l’aide de la System.Windows.Forms.CurrencyManager classe . Les AddNewméthodes , EndCurrentEditet CancelCurrentEdit de la classe sont responsables de la System.Windows.Forms.CurrencyManager prise en charge transactionnelle de l’ajout de nouveaux éléments. Toutefois, cette fonctionnalité dépend des éléments prenant en charge le comportement transactionnel via l’interface IEditableObject . Si les éléments ne prennent pas en charge cette interface, l’élément est toujours ajouté à la liste, quels que soient les appels suivants à CancelCurrentEdit.

• Le modèle plus récent prend en charge un scénario de liaison de données plus robuste via la classe générique BindingList<T> , qui implémente les IBindingList interfaces et ICancelAddNew . Dans ce cas, la prise en charge transactionnelle est gérée directement par la BindingList<T> collection.

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.

Voir aussi

• IBindingList
• CurrencyManager
• IEditableObject
• BindingList<T>