INotifyCollectionChanged Interfejs
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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. |