ICancelAddNew Interface

Définition

Espace de noms:
System.ComponentModel
Assembly:
System.dll
Assembly:
netstandard.dll

Ajoute une fonctionnalité 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é ou restauré. La AddNew méthode de la collection est utilisée pour ajouter provisoirement l’élément, qui est ensuite traité par le biais des 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é.

Note

Dans certains scénarios, tels que Windows Forms liaison de données complexes, la collection peut recevoir CancelNew ou EndNew appels d’é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 ; annulez ou validez 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 directement liée aux données à l’aide de la classe System.Windows.Forms.CurrencyManager. Les méthodes AddNew, EndCurrentEdit et CancelCurrentEdit de la classe System.Windows.Forms.CurrencyManager sont responsables de la 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ériqueBindingList<T>, qui implémente les interfaces et ICancelAddNew les IBindingList interfaces. Dans ce cas, la prise en charge transactionnelle est gérée directement par la BindingList<T> collection.

Méthodes

Nom Description
CancelNew(Int32)

Ignore 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