INotifyCollectionChanged Interfejs

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Collections.Specialized
Zestaw:
System.ObjectModel.dll
Zestaw:
WindowsBase.dll
Zestaw:
System.dll
Zestaw:
netstandard.dll

Powiadamia odbiorniki o zmianach dynamicznych, na przykład po dodaniu i usunięciu elementu lub wyczyszczonej całej liście.

public interface class INotifyCollectionChanged
public interface INotifyCollectionChanged
type INotifyCollectionChanged = interface
Public Interface INotifyCollectionChanged
Pochodne

Uwagi

Możesz wyliczyć dowolną kolekcję, która implementuje interfejs IEnumerable. Aby jednak skonfigurować powiązania dynamiczne tak, aby wstawienie lub usunięcie w kolekcji automatycznie zaktualizowało interfejs użytkownika, kolekcja musi zaimplementować interfejs INotifyCollectionChanged. Ten interfejs uwidacznia CollectionChanged zdarzenie, które musi zostać zgłoszone za każdym razem, gdy zmienia się podstawowa kolekcja.

WPF udostępnia klasę ObservableCollection<T>, która jest wbudowaną implementacją kolekcji danych, która uwidacznia interfejs INotifyCollectionChanged. Aby zapoznać się z przykładem, zobacz How to: Create and Bind to an ObservableCollection (Instrukcje: tworzenie i wiązanie z obiektem ObservableCollection).

Poszczególne obiekty danych w kolekcji muszą spełniać wymagania opisane w artykule Omówienie źródeł powiązań.

Przed wdrożeniem własnej kolekcji rozważ użycie ObservableCollection<T> lub jednej z istniejących klas kolekcji, takich jak, między innymi, List<T>, Collection<T> i BindingList<T>.

Jeśli masz zaawansowany scenariusz i chcesz zaimplementować własną kolekcję, rozważ użycie metody IList, która udostępnia niegeneryjną kolekcję obiektów, do których można uzyskać dostęp indywidualnie według indeksu i zapewnia najlepszą wydajność.

Zdarzenia

CollectionChanged

Występuje, gdy kolekcja ulegnie zmianie.

Dotyczy

Zobacz też