ICancelAddNew, interface
Assembly : System (dans system.dll)
L'interface ICancelAddNew permet à une collection d'ajouter un nouvel élément d'une manière extensible. Le nouvel élément peut être validé par la suite ou être restauré. La méthode AddNew de la collection est utilisée pour ajouter provisoirement l'élément qui est traité par la suite via les opérations suivantes :
-
La méthode EndNew valide l'addition en attente d'une manière explicite.
-
L'exécution d'une autre opération de collection telle qu'une insertion, une suppression ou un déplacement valide l'addition en attente d'une manière implicite.
-
La méthode CancelNew annule la méthode en attente si elle n'a pas encore été validée.
 Remarque |
|---|
| Dans certains scénarios tels que la liaison de données complexe Windows Forms, la collection peut recevoir des appels CancelNew ou EndNew pour les éléments autres que l'élément récemment ajouté. (Chaque élément est en général 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é. |
Deux modèles autorisent l'addition transactionnelle d'un élément à une collection liée aux données :
-
L'ancien modèle repose directement sur une collection qui implémente l'interface IBindingList et qui 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 chargées de la prise en charge transactionnelle permettant d'ajouter de nouveaux éléments. Toutefois, cette fonctionnalité repose sur les éléments qui prennent en charge le comportement transactionnel via l'interface IEditableObject. Si les éléments ne prennent pas en charge cette interface, l'élément sera toujours ajouté à la liste, indépendamment des appels ultérieurs à CancelCurrentEdit.
-
Le modèle plus récent prend en charge un scénario de liaison de données plus fiable via la classe BindingList générique qui implémente les interfaces IBindingList et ICancelAddNew. Dans ce cas, la prise en charge transactionnelle est gérée directement par la collection BindingList.
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition
Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.
