INotifyCollectionChanged Interface

Définition

Notifie des écouteurs de modifications dynamiques, comme quand un élément est ajouté ou supprimé, ou que l’intégralité de la liste est effacée.Notifies listeners of dynamic changes, such as when an item is added and removed or the whole list is cleared.

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

Remarques

Vous pouvez énumérer toute collection qui implémente le IEnumerable interface.You can enumerate over any collection that implements the IEnumerable interface. Toutefois, pour définir des liaisons dynamiques afin que les insertions ou les suppressions dans la collection de mettre à jour le Interface utilisateurUI automatiquement, la collection doit implémenter le INotifyCollectionChanged interface.However, to set up dynamic bindings so that insertions or deletions in the collection update the Interface utilisateurUI automatically, the collection must implement the INotifyCollectionChanged interface. Cette interface expose le CollectionChanged événement qui doit être déclenché chaque fois que la collection sous-jacente est modifiée.This interface exposes the CollectionChanged event that must be raised whenever the underlying collection changes.

WPFWPF fournit le ObservableCollection<T> (classe), qui est une implémentation intégrée d’une collection de données qui expose le INotifyCollectionChanged interface.provides the ObservableCollection<T> class, which is a built-in implementation of a data collection that exposes the INotifyCollectionChanged interface. Pour voir un exemple, consultez Comment : Créer et lier à un ObservableCollection.For an example, see How to: Create and Bind to an ObservableCollection.

Les objets de données individuels dans la collection doivent satisfaire aux exigences décrites dans le vue d’ensemble des Sources de liaison.The individual data objects within the collection must satisfy the requirements described in the Binding Sources Overview.

Avant d’implémenter votre propre collection, envisagez d’utiliser ObservableCollection<T> ou une des collections existantes classes, telles que List<T>, Collection<T>, et BindingList<T>, entre autres.Before implementing your own collection, consider using ObservableCollection<T> or one of the existing collection classes, such as List<T>, Collection<T>, and BindingList<T>, among many others.

Si vous avez un scénario avancé et que vous souhaitez implémenter votre propre collection, envisagez d’utiliser IList, qui fournit une collection non générique d’objets accessibles séparément par index et fournit les meilleures performances.If you have an advanced scenario and want to implement your own collection, consider using IList, which provides a non-generic collection of objects that can be individually accessed by index and provides the best performance.

Événements

CollectionChanged

Se produit lorsque la collection est modifiée.Occurs when the collection changes.

S’applique à

Voir aussi