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 IEnumerable interfejs. Jednak aby skonfigurować powiązania dynamiczne tak, aby wstawienie lub usunięcie w kolekcji automatycznie zaktualizowało interfejs użytkownika, kolekcja musi zaimplementować INotifyCollectionChanged interfejs. Ten interfejs uwidacznia CollectionChanged zdarzenie, które należy zgłosić za każdym razem, gdy podstawowa kolekcja ulegnie zmianie.
WPF udostępnia klasę ObservableCollection<T> , która jest wbudowaną implementacją kolekcji danych, która uwidacznia INotifyCollectionChanged interfejs. Przykład można znaleźć w temacie 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 temacie Binding Sources Overview (Omówienie powiązań źródeł).
Przed wdrożeniem własnej kolekcji rozważ użycie ObservableCollection<T> lub jedną z istniejących klas kolekcji, takich jak List<T>, Collection<T>i BindingList<T>, między innymi.
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 przez indeks i zapewnia najlepszą wydajność.
Zdarzenia
| CollectionChanged |
Występuje, gdy kolekcja ulegnie zmianie. |