INotifyCollectionChanged Schnittstelle

Definition

Benachrichtigt Listener über dynamische Änderungen – beispielsweise, wenn ein Element hinzugefügt oder entfernt wird oder die gesamte Liste geleert wird.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
Abgeleitet

Hinweise

Sie können jede Auflistung auflisten, die die IEnumerable-Schnittstelle implementiert.You can enumerate over any collection that implements the IEnumerable interface. Wenn Sie jedoch dynamische Bindungen einrichten möchten, sodass die UIUI von Einfügungen oder Löschungen in der Auflistung automatisch aktualisiert werden, muss die-Auflistung die INotifyCollectionChanged-Schnittstelle implementieren.However, to set up dynamic bindings so that insertions or deletions in the collection update the UIUI automatically, the collection must implement the INotifyCollectionChanged interface. Diese Schnittstelle macht das CollectionChanged Ereignis verfügbar, das bei jeder Änderung der zugrunde liegenden Auflistung ausgelöst werden muss.This interface exposes the CollectionChanged event that must be raised whenever the underlying collection changes.

WPFWPF stellt die ObservableCollection<T>-Klasse bereit, bei der es sich um eine integrierte Implementierung einer Datensammlung handelt, die die INotifyCollectionChanged-Schnittstelle verfügbar macht.provides the ObservableCollection<T> class, which is a built-in implementation of a data collection that exposes the INotifyCollectionChanged interface. Ein Beispiel finden Sie unter Gewusst wie: Erstellen und Binden an ObservableCollection.For an example, see How to: Create and Bind to an ObservableCollection.

Die einzelnen Datenobjekte in der Auflistung müssen die in der Übersicht über Bindungs Quellenbeschriebenen Anforderungen erfüllen.The individual data objects within the collection must satisfy the requirements described in the Binding Sources Overview.

Bevor Sie eine eigene Auflistung implementieren, erwägen Sie ObservableCollection<T> oder einer vorhandenen Sammlung Klassen, z. B. List<T>, Collection<T>, und BindingList<T>, a.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.

Wenn Sie ein erweitertes Szenario haben und eine eigene Auflistung implementieren möchten, empfiehlt es sich, IListzu verwenden, das eine nicht generische Auflistung von Objekten bereitstellt, auf die einzeln über einen Index zugegriffen werden kann und die die beste Leistung bietet.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.

Ereignisse

CollectionChanged

Tritt auf, wenn sich die Auflistung ändert.Occurs when the collection changes.

Gilt für:

Siehe auch