BindingListCollectionView Klasa
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.
CollectionView Reprezentuje obiekty dla kolekcji, które implementują IBindingListobiekty danych , takie jak widoki danych Microsoft ActiveX Data Objects (ADO).
public ref class BindingListCollectionView sealed : System::Windows::Data::CollectionView, System::Collections::IComparer, System::ComponentModel::IEditableCollectionView, System::ComponentModel::IItemProperties
public ref class BindingListCollectionView sealed : System::Windows::Data::CollectionView, System::Collections::IComparer, System::ComponentModel::ICollectionViewLiveShaping, System::ComponentModel::IEditableCollectionView, System::ComponentModel::IItemProperties
public sealed class BindingListCollectionView : System.Windows.Data.CollectionView, System.Collections.IComparer, System.ComponentModel.IEditableCollectionView, System.ComponentModel.IItemProperties
public sealed class BindingListCollectionView : System.Windows.Data.CollectionView, System.Collections.IComparer, System.ComponentModel.ICollectionViewLiveShaping, System.ComponentModel.IEditableCollectionView, System.ComponentModel.IItemProperties
type BindingListCollectionView = class
inherit CollectionView
interface IComparer
interface IEditableCollectionView
interface IItemProperties
type BindingListCollectionView = class
inherit CollectionView
interface IComparer
interface IEditableCollectionView
interface ICollectionViewLiveShaping
interface IItemProperties
type BindingListCollectionView = class
inherit CollectionView
interface IComparer
interface ICollectionViewLiveShaping
interface IEditableCollectionView
interface IItemProperties
Public NotInheritable Class BindingListCollectionView
Inherits CollectionView
Implements IComparer, IEditableCollectionView, IItemProperties
Public NotInheritable Class BindingListCollectionView
Inherits CollectionView
Implements ICollectionViewLiveShaping, IComparer, IEditableCollectionView, IItemProperties
- Dziedziczenie
- Implementuje
Uwagi
Wszystkie kolekcje mają domyślną wartość CollectionView. W przypadku kolekcji implementujących IBindingListView lub IBindingListdomyślny widok kolekcji to BindingListCollectionView. W szczególności IBindingList jest wymagany dla BindingListCollectionViewprogramu i IBindingListView jest opcjonalnym interfejsem, który zapewnia dodatkową obsługę sortowania i filtrowania.
Jeśli masz wiele BindingListCollectionView obiektów, a bazowe źródło jest obiektem DataTableDataViewlub , obiekty widoku nie sortują ani nie filtrują niezależnie. Jeśli na przykład masz dwa BindingListCollectionView obiekty skojarzone z tym samym DataTable i przeprowadzasz sortowanie w jednym z widoków, kolejność elementów w innym widoku może mieć wpływ. Dzieje się tak, ponieważ BindingListCollectionView obiekty używają elementów bazowych IBindingList do sortowania i filtrowania funkcji.
Aby uzyskać więcej informacji na temat widoków kolekcji, zobacz Omówienie powiązania danych.
Konstruktory
| Nazwa | Opis |
|---|---|
| BindingListCollectionView(IBindingList) |
Inicjuje wystąpienie BindingListCollectionView danej listy. |
Właściwości
| Nazwa | Opis |
|---|---|
| AllowsCrossThreadChanges |
Pobiera wartość wskazującą, czy wątek inny niż ten, który utworzył CollectionView obiekt , może zmienić wartość SourceCollection. (Odziedziczone po CollectionView) |
| CanAddNew |
Pobiera wartość wskazującą, czy do kolekcji można dodać nowy element. |
| CanCancelEdit |
Pobiera wartość wskazującą, czy widok kolekcji może odrzucić oczekujące zmiany i przywrócić oryginalne wartości edytowanego obiektu. |
| CanChangeLiveFiltering |
Pobiera wartość wskazującą, czy ten widok obsługuje włączanie lub wyłączanie filtrowania danych w czasie rzeczywistym. |
| CanChangeLiveGrouping |
Pobiera wartość wskazującą, czy ten widok obsługuje włączanie lub wyłączanie grupowania danych w czasie rzeczywistym. |
| CanChangeLiveSorting |
Pobiera wartość wskazującą, czy ten widok obsługuje włączanie lub wyłączanie sortowania danych w czasie rzeczywistym. |
| CanCustomFilter |
Pobiera wartość wskazującą, czy widok obsługuje filtrowanie niestandardowe. |
| CanFilter |
Pobiera wartość wskazującą, czy widok obsługuje filtrowanie oparte na wywołaniu zwrotnym. |
| CanGroup |
Pobiera wartość wskazującą, czy widok obsługuje grupowanie. |
| CanRemove |
Pobiera wartość wskazującą, czy element można usunąć z kolekcji. |
| CanSort |
Pobiera wartość wskazującą, czy kolekcja obsługuje sortowanie. |
| Comparer |
Zwraca obiekt, którego można użyć do porównywania elementów w widoku. (Odziedziczone po CollectionView) |
| Count |
Pobiera szacowaną liczbę rekordów w kolekcji. |
| Culture |
Pobiera lub ustawia informacje o kulturze do użycia podczas sortowania. (Odziedziczone po CollectionView) |
| CurrentAddItem |
Pobiera element, który jest dodawany podczas bieżącej transakcji dodawania. |
| CurrentEditItem |
Pobiera element w kolekcji, który jest edytowany. |
| CurrentItem |
Pobiera bieżący element w widoku. (Odziedziczone po CollectionView) |
| CurrentPosition |
Pobiera położenie CurrentItem porządkowe w widoku (opcjonalnie posortowany i filtrowany). (Odziedziczone po CollectionView) |
| CustomFilter |
Pobiera lub ustawia filtr niestandardowy. |
| Dispatcher |
Pobiera elementDispatcher, z który DispatcherObject jest skojarzony. (Odziedziczone po DispatcherObject) |
| Filter |
Pobiera lub ustawia metodę używaną do określenia, czy element jest odpowiedni do włączenia do widoku. (Odziedziczone po CollectionView) |
| GroupBySelector |
Pobiera lub ustawia delegata, aby wybrać GroupDescription element jako funkcję grupy nadrzędnej i jej poziom. |
| GroupDescriptions |
Pobiera kolekcję GroupDescription obiektów opisujących sposób grupowania elementów w kolekcji w widoku. |
| Groups |
Pobiera grupy najwyższego poziomu. |
| IsAddingNew |
Pobiera wartość wskazującą, czy transakcja dodawania jest w toku. |
| IsCurrentAfterLast |
Pobiera wartość wskazującą, czy CurrentItem widok znajduje się poza końcem kolekcji. (Odziedziczone po CollectionView) |
| IsCurrentBeforeFirst |
Pobiera wartość wskazującą, czy CurrentItem widok znajduje się przed rozpoczęciem kolekcji. (Odziedziczone po CollectionView) |
| IsCurrentInSync |
Pobiera wartość wskazującą, czy element CurrentItem znajduje się w obiekcie CurrentPosition. (Odziedziczone po CollectionView) |
| IsDataInGroupOrder |
Pobiera lub ustawia wartość wskazującą, czy lista elementów (po zastosowaniu sortowania i filtrów, jeśli istnieje) jest już w prawidłowej kolejności grupowania. |
| IsDynamic |
Pobiera wartość wskazującą, czy podstawowa kolekcja udostępnia powiadomienia o zmianie. (Odziedziczone po CollectionView) |
| IsEditingItem |
Pobiera wartość wskazującą, czy transakcja edycji jest w toku. |
| IsEmpty |
Zwraca wartość wskazującą, czy wynikowy (filtrowany) widok jest pusty. |
| IsInUse |
Pobiera wartość wskazującą, czy dowolny obiekt subskrybuje zdarzenia tego obiektu CollectionView. (Odziedziczone po CollectionView) |
| IsLiveFiltering |
Pobiera lub ustawia wartość wskazującą, czy filtrowanie danych w czasie rzeczywistym jest włączone. |
| IsLiveGrouping |
Pobiera lub ustawia wartość wskazującą, czy grupowanie danych w czasie rzeczywistym jest włączone. |
| IsLiveSorting |
Pobiera lub ustawia wartość wskazującą, czy sortowanie danych w czasie rzeczywistym jest włączone. |
| IsRefreshDeferred |
Pobiera wartość wskazującą, czy istnieje zaległa DeferRefresh() wartość w użyciu. (Odziedziczone po CollectionView) |
| ItemProperties |
Pobiera kolekcję obiektów opisujących właściwości elementów w kolekcji. |
| LiveFilteringProperties |
Pobiera kolekcję ciągów, które określają właściwości, które uczestniczą w filtrowaniu danych w czasie rzeczywistym. |
| LiveGroupingProperties |
Pobiera kolekcję ciągów, które określają właściwości, które uczestniczą w grupowaniu danych w czasie rzeczywistym. |
| LiveSortingProperties |
Pobiera kolekcję ciągów, które określają właściwości, które uczestniczą w sortowaniu danych w czasie rzeczywistym. |
| NeedsRefresh |
Pobiera wartość wskazującą, czy widok musi zostać odświeżony. (Odziedziczone po CollectionView) |
| NewItemPlaceholderPosition |
Pobiera lub ustawia położenie symbolu zastępczego nowego elementu w elemencie BindingListCollectionView. |
| SortDescriptions |
Pobiera kolekcję SortDescription obiektów opisujących sposób sortowania elementów w kolekcji w widoku. |
| SourceCollection |
Zwraca podstawową niefiltrowaną kolekcję. (Odziedziczone po CollectionView) |
| UpdatedOutsideDispatcher |
Pobiera wartość wskazującą, czy konieczne było zaktualizowanie dziennika zmian, ponieważ CollectionChanged powiadomienie zostało odebrane w innym wątku bez uprzedniego wprowadzenia dyspozytora wątku interfejsu użytkownika. (Odziedziczone po CollectionView) |
Metody
| Nazwa | Opis |
|---|---|
| AddNew() |
Uruchamia dodaj transakcję i zwraca oczekujący nowy element. |
| CancelEdit() |
Kończy edycję transakcji i, jeśli to możliwe, przywraca oryginalną wartość do elementu. |
| CancelNew() |
Kończy dodawanie transakcji i odrzuca oczekujący nowy element. |
| CheckAccess() |
Określa, czy wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject) |
| ClearChangeLog() |
Przestarzałe.
Czyści wszelkie oczekujące zmiany z dziennika zmian. (Odziedziczone po CollectionView) |
| ClearPendingChanges() |
Czyści nieprzetworzoną zmianę w kolekcji. (Odziedziczone po CollectionView) |
| CommitEdit() |
Kończy edycję transakcji i zapisuje oczekujące zmiany. |
| CommitNew() |
Kończy dodawanie transakcji i zapisuje oczekujący nowy element. |
| Contains(Object) |
Zwraca wartość wskazującą, czy dany element należy do widoku kolekcji. |
| DeferRefresh() |
Wprowadza cykl odroczenia, którego można użyć do scalania zmian w widoku i opóźniania automatycznego odświeżania. (Odziedziczone po CollectionView) |
| DetachFromSourceCollection() |
Odłącza podstawową kolekcję od tego widoku kolekcji, aby umożliwić zbieranie pamięci w widoku zbierania pamięci. |
| EditItem(Object) |
Rozpoczyna transakcję edycji określonego elementu. |
| Equals(Object) |
Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object) |
| GetEnumerator() |
Zwraca obiekt, którego można użyć do wyliczenia elementów w widoku. (Odziedziczone po CollectionView) |
| GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
| GetItemAt(Int32) |
Pobiera element na określonej pozycji w widoku. |
| GetType() |
Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object) |
| IndexOf(Object) |
Zwraca indeks, do którego należy dany element w widoku kolekcji. |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object) |
| MoveCurrentTo(Object) |
Ustawia określony element jako CurrentItem element w widoku. (Odziedziczone po CollectionView) |
| MoveCurrentToFirst() |
Ustawia pierwszy element w widoku jako CurrentItem. (Odziedziczone po CollectionView) |
| MoveCurrentToLast() |
Ustawia ostatni element w widoku jako CurrentItem. (Odziedziczone po CollectionView) |
| MoveCurrentToNext() |
Ustawia element po elemencie CurrentItem w widoku jako CurrentItem. (Odziedziczone po CollectionView) |
| MoveCurrentToPosition(Int32) |
Ustawia element w określonym indeksie jako CurrentItem element w widoku. |
| MoveCurrentToPrevious() |
Ustawia element przed elementem CurrentItem w widoku jako CurrentItem. (Odziedziczone po CollectionView) |
| OKToChangeCurrent() |
Zwraca wartość wskazującą, czy widok może zmienić element .CurrentItem (Odziedziczone po CollectionView) |
| OnAllowsCrossThreadChangesChanged() |
Występuje, gdy AllowsCrossThreadChanges właściwość ulegnie zmianie. (Odziedziczone po CollectionView) |
| OnBeginChangeLogging(NotifyCollectionChangedEventArgs) |
Przestarzałe.
Wywoływana przez klasę bazową w celu powiadomienia klasy pochodnej o tym, że CollectionChanged zdarzenie zostało opublikowane w kolejce komunikatów. (Odziedziczone po CollectionView) |
| OnCollectionChanged(NotifyCollectionChangedEventArgs) |
CollectionChanged Wywołuje zdarzenie. (Odziedziczone po CollectionView) |
| OnCollectionChanged(Object, NotifyCollectionChangedEventArgs) |
CollectionChanged Wywołuje zdarzenie. (Odziedziczone po CollectionView) |
| OnCurrentChanged() |
CurrentChanged Wywołuje zdarzenie. (Odziedziczone po CollectionView) |
| OnCurrentChanging() |
CurrentChanging Zgłasza zdarzenie, które nie można anulować. (Odziedziczone po CollectionView) |
| OnCurrentChanging(CurrentChangingEventArgs) |
CurrentChanging Wywołuje zdarzenie z określonymi argumentami. (Odziedziczone po CollectionView) |
| OnPropertyChanged(PropertyChangedEventArgs) |
PropertyChanged Wywołuje zdarzenie przy użyciu określonych argumentów. (Odziedziczone po CollectionView) |
| PassesFilter(Object) |
Zwraca wartość wskazującą, czy określony element w kolekcji bazowej należy do widoku. |
| ProcessCollectionChanged(NotifyCollectionChangedEventArgs) |
Gdy zastąpisz klasę pochodną, przetwarza pojedynczą zmianę wątku interfejsu użytkownika. (Odziedziczone po CollectionView) |
| ProcessPendingChanges() |
Gwarantuje, że wszystkie oczekujące zmiany w kolekcji zostały zatwierdzone. (Odziedziczone po CollectionView) |
| Refresh() |
Ponownie tworzy widok. (Odziedziczone po CollectionView) |
| RefreshOrDefer() |
Odświeża widok lub określa, że widok musi zostać odświeżony po zakończeniu cyklu odroczenia. (Odziedziczone po CollectionView) |
| RefreshOverride() |
Ponownie tworzy widok. (Odziedziczone po CollectionView) |
| Remove(Object) |
Usuwa określony element z kolekcji. |
| RemoveAt(Int32) |
Usuwa element na określonej pozycji z kolekcji. |
| SetCurrent(Object, Int32, Int32) |
Ustawia określony element i indeks jako wartości CurrentItem właściwości i CurrentPosition . Tę metodę można wywołać z konstruktora klasy pochodnej. (Odziedziczone po CollectionView) |
| SetCurrent(Object, Int32) |
Ustawia określony element i indeks jako wartości CurrentItem właściwości i CurrentPosition . (Odziedziczone po CollectionView) |
| ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
| VerifyAccess() |
Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject) |
Zdarzenia
| Nazwa | Opis |
|---|---|
| CollectionChanged |
Występuje po zmianie widoku. (Odziedziczone po CollectionView) |
| CurrentChanged |
Występuje po CurrentItem zmianie. (Odziedziczone po CollectionView) |
| CurrentChanging |
Występuje w przypadku CurrentItem zmiany. (Odziedziczone po CollectionView) |
| PropertyChanged |
Występuje, gdy wartość właściwości uległa zmianie. (Odziedziczone po CollectionView) |
Jawne implementacje interfejsu
| Nazwa | Opis |
|---|---|
| IComparer.Compare(Object, Object) |
Ten element członkowski obsługuje infrastrukturę Windows Presentation Foundation (WPF) i nie ma być używany bezpośrednio z kodu. |
| IEnumerable.GetEnumerator() |
IEnumerator Zwraca obiekt, którego można użyć do wyliczenia elementów w widoku. (Odziedziczone po CollectionView) |
| INotifyCollectionChanged.CollectionChanged |
Występuje po zmianie widoku. (Odziedziczone po CollectionView) |
| INotifyPropertyChanged.PropertyChanged |
Występuje, gdy wartość właściwości ulegnie zmianie. (Odziedziczone po CollectionView) |
Metody rozszerzania
| Nazwa | Opis |
|---|---|
| AsParallel(IEnumerable) |
Umożliwia równoległość zapytania. |
| AsQueryable(IEnumerable) |
Konwertuje IEnumerable na IQueryable. |
| Cast<TResult>(IEnumerable) |
Rzutuje elementy IEnumerable do określonego typu. |
| OfType<TResult>(IEnumerable) |
Filtruje elementy IEnumerable na podstawie określonego typu. |