ICancelAddNew Interface
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Ajoute la fonction transactionnelle lors de l'ajout d'un nouvel élément à une collection.
public interface class ICancelAddNewpublic interface ICancelAddNewtype ICancelAddNew = interfacePublic 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 :
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. |
