ListCollectionView Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет представление коллекции для коллекций, реализующих IList.
public ref class ListCollectionView : System::Windows::Data::CollectionView, System::Collections::IComparer, System::ComponentModel::IEditableCollectionView, System::ComponentModel::IItemProperties
public ref class ListCollectionView : System::Windows::Data::CollectionView, System::Collections::IComparer, System::ComponentModel::IEditableCollectionViewAddNewItem, System::ComponentModel::IItemProperties
public ref class ListCollectionView : System::Windows::Data::CollectionView, System::Collections::IComparer, System::ComponentModel::ICollectionViewLiveShaping, System::ComponentModel::IEditableCollectionViewAddNewItem, System::ComponentModel::IItemProperties
public class ListCollectionView : System.Windows.Data.CollectionView, System.Collections.IComparer, System.ComponentModel.IEditableCollectionView, System.ComponentModel.IItemProperties
public class ListCollectionView : System.Windows.Data.CollectionView, System.Collections.IComparer, System.ComponentModel.IEditableCollectionViewAddNewItem, System.ComponentModel.IItemProperties
public class ListCollectionView : System.Windows.Data.CollectionView, System.Collections.IComparer, System.ComponentModel.ICollectionViewLiveShaping, System.ComponentModel.IEditableCollectionViewAddNewItem, System.ComponentModel.IItemProperties
type ListCollectionView = class
inherit CollectionView
interface IComparer
interface IEditableCollectionView
interface IItemProperties
type ListCollectionView = class
inherit CollectionView
interface IComparer
interface IEditableCollectionViewAddNewItem
interface IEditableCollectionView
interface IItemProperties
type ListCollectionView = class
inherit CollectionView
interface IComparer
interface IEditableCollectionViewAddNewItem
interface IEditableCollectionView
interface ICollectionViewLiveShaping
interface IItemProperties
type ListCollectionView = class
inherit CollectionView
interface IComparer
interface ICollectionViewLiveShaping
interface IEditableCollectionView
interface IEditableCollectionViewAddNewItem
interface IItemProperties
Public Class ListCollectionView
Inherits CollectionView
Implements IComparer, IEditableCollectionView, IItemProperties
Public Class ListCollectionView
Inherits CollectionView
Implements IComparer, IEditableCollectionViewAddNewItem, IItemProperties
Public Class ListCollectionView
Inherits CollectionView
Implements ICollectionViewLiveShaping, IComparer, IEditableCollectionViewAddNewItem, IItemProperties
- Наследование
- Реализации
Комментарии
При привязке к коллекции данных может потребоваться отсортировать, отфильтровать или сгруппировать данные. Для этого используются представления коллекции. Вы можете представить CollectionView как слой на вершине коллекции источников привязки, которая позволяет перемещаться и отображать исходную коллекцию на основе сортировки, фильтрации и группирования, все без необходимости управлять базовой исходной коллекцией. Если исходная коллекция реализует интерфейс INotifyCollectionChanged, изменения, вызванные событием CollectionChanged, передаются в представления.
Все коллекции имеют значение по умолчанию CollectionView. Для всех коллекций, реализующих IList, ListCollectionView объект является объектом представления по умолчанию. Это BindingListCollectionView класс представления коллекции, используемый для коллекций, реализующих IBindingList. Чтобы получить представление по умолчанию, используйте метод GetDefaultView. Пример см. в статье "Практическое руководство. Получение представления по умолчанию коллекции данных".
Дополнительные сведения о представлениях коллекции см. в обзоре привязки данных.
Конструкторы
| Имя | Описание |
|---|---|
| ListCollectionView(IList) |
Инициализирует новый экземпляр класса с помощью предоставленной ListCollectionView коллекции, реализующей IList. |
Свойства
| Имя | Описание |
|---|---|
| ActiveComparer |
Возвращает или задает текущий активный сопоставитель, используемый при сортировке. |
| ActiveFilter |
Возвращает или задает текущий активный Filter обратный вызов. |
| AllowsCrossThreadChanges |
Возвращает значение, указывающее, может ли поток, отличный от созданного CollectionView , изменить SourceCollection. (Унаследовано от CollectionView) |
| CanAddNew |
Возвращает значение, указывающее, можно ли добавить новый элемент в коллекцию. |
| CanAddNewItem |
Возвращает значение, указывающее, можно ли добавить указанный объект в коллекцию. |
| CanCancelEdit |
Возвращает значение, указывающее, может ли представление коллекции отменить ожидающие изменения и восстановить исходные значения измененного объекта. |
| CanChangeLiveFiltering |
Возвращает значение, указывающее, поддерживает ли представление коллекции фильтрацию данных в режиме реального времени в режиме реального времени. |
| CanChangeLiveGrouping |
Возвращает значение, указывающее, поддерживает ли представление коллекции включение и отключение группирования данных в режиме реального времени. |
| CanChangeLiveSorting |
Возвращает значение, указывающее, поддерживает ли представление коллекции отсортирование данных в режиме реального времени в режиме реального времени. |
| CanFilter |
Возвращает значение, указывающее, поддерживает ли представление фильтрацию на основе обратных вызовов. |
| CanGroup |
Возвращает значение, указывающее, поддерживает ли представление коллекции группирование. |
| CanRemove |
Возвращает значение, указывающее, можно ли удалить элемент из коллекции. |
| CanSort |
Возвращает значение, указывающее, поддерживает ли представление коллекции сортировку. |
| Comparer |
Возвращает объект, который можно использовать для сравнения элементов в представлении. (Унаследовано от CollectionView) |
| Count |
Возвращает предполагаемое количество записей. |
| Culture |
Возвращает или задает сведения о языке и региональных параметрах для использования во время сортировки. (Унаследовано от CollectionView) |
| CurrentAddItem |
Возвращает элемент, добавляемый во время текущей транзакции добавления. |
| CurrentEditItem |
Возвращает элемент в коллекции, которая редактируется. |
| CurrentItem |
Возвращает текущий элемент в представлении. (Унаследовано от CollectionView) |
| CurrentPosition |
Получает порядковое положение CurrentItem внутри (необязательно отсортированного и отфильтрованного) представления. (Унаследовано от CollectionView) |
| CustomSort |
Возвращает или задает пользовательский объект, реализующий IComparer сортировку элементов в представлении. |
| Dispatcher |
Dispatcher Возвращает это DispatcherObject значение, с которым связано. (Унаследовано от DispatcherObject) |
| Filter |
Возвращает или задает метод, используемый для определения того, подходит ли элемент для включения в представление. |
| GroupBySelector |
Получает или задает делегат для выбора GroupDescription в качестве функции родительской группы и его уровня. |
| GroupDescriptions |
Возвращает коллекцию GroupDescription объектов, описывающих группирование элементов в коллекции в представлении. |
| Groups |
Возвращает группы верхнего уровня. |
| InternalCount |
Возвращает количество записей в объекте InternalList. |
| InternalList |
Возвращает отфильтрованный и отсортированный список элементов. |
| IsAddingNew |
Возвращает значение, указывающее, выполняется ли транзакция добавления. |
| IsCurrentAfterLast |
Возвращает значение, указывающее, выходит ли CurrentItem представление за пределы коллекции. (Унаследовано от CollectionView) |
| IsCurrentBeforeFirst |
Возвращает значение, указывающее, находится ли CurrentItem представление перед началом коллекции. (Унаследовано от CollectionView) |
| IsCurrentInSync |
Возвращает значение, указывающее, находится ли объект CurrentItem в объекте CurrentPosition. (Унаследовано от CollectionView) |
| IsDataInGroupOrder |
Возвращает или задает значение, указывающее, находится ли список элементов (после применения сортировки и фильтров, если таковые имеются) уже в правильном порядке для группировки. |
| IsDynamic |
Возвращает значение, указывающее, предоставляет ли базовая коллекция уведомления об изменениях. (Унаследовано от CollectionView) |
| IsEditingItem |
Возвращает значение, указывающее, выполняется ли транзакция редактирования. |
| IsEmpty |
Возвращает значение, указывающее, является ли итоговое (отфильтрованное) представление пустым. |
| IsGrouping |
Возвращает значение, указывающее, существуют ли группы в представлении. |
| IsInUse |
Возвращает значение, указывающее, является ли любой объект подписывающимся на события этого CollectionViewобъекта. (Унаследовано от CollectionView) |
| IsLiveFiltering |
Возвращает или задает значение, указывающее, включена ли фильтрация данных в режиме реального времени. |
| IsLiveGrouping |
Возвращает или задает значение, указывающее, включена ли группирование данных в режиме реального времени. |
| IsLiveSorting |
Возвращает или задает значение, указывающее, включена ли сортировка в режиме реального времени. |
| IsRefreshDeferred |
Возвращает значение, указывающее, существует ли выдающееся DeferRefresh() значение. (Унаследовано от CollectionView) |
| ItemProperties |
Возвращает коллекцию объектов, описывающих свойства элементов в коллекции. |
| LiveFilteringProperties |
Возвращает коллекцию строк, которые указывают свойства, участвующие в фильтрации данных в режиме реального времени. |
| LiveGroupingProperties |
Возвращает коллекцию строк, которые указывают свойства, участвующие в группировке данных в режиме реального времени. |
| LiveSortingProperties |
Возвращает коллекцию строк, которые указывают свойства, участвующие в сортировке данных в режиме реального времени. |
| NeedsRefresh |
Возвращает значение, указывающее, требуется ли обновить представление. (Унаследовано от CollectionView) |
| NewItemPlaceholderPosition |
Возвращает или задает позицию заполнителя нового элемента в элементе ListCollectionView. |
| SortDescriptions |
Возвращает коллекцию SortDescription объектов, описывающих сортировку элементов в коллекции в представлении. |
| SourceCollection |
Возвращает базовую нефильтрованную коллекцию. (Унаследовано от CollectionView) |
| UpdatedOutsideDispatcher |
Возвращает значение, указывающее, требуется ли обновить журнал изменений, так как CollectionChanged уведомление получено в другом потоке без первого ввода диспетчера потоков пользовательского интерфейса ( пользовательского интерфейса). (Унаследовано от CollectionView) |
| UsesLocalArray |
Возвращает значение, указывающее, требуется ли частная копия данных для сортировки и фильтрации. |
Методы
| Имя | Описание |
|---|---|
| AddNew() |
Запускает транзакцию добавления и возвращает ожидающий новый элемент. |
| AddNewItem(Object) |
Добавляет указанный объект в коллекцию. |
| CancelEdit() |
Завершает транзакцию редактирования и, если это возможно, восстанавливает исходное значение элемента. |
| CancelNew() |
Завершает транзакцию добавления и удаляет ожидающий новый элемент. |
| CheckAccess() |
Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject. (Унаследовано от DispatcherObject) |
| ClearChangeLog() |
Устаревшие..
Очищает все ожидающие изменения из журнала изменений. (Унаследовано от CollectionView) |
| ClearPendingChanges() |
Очищает необработанные изменения в коллекции. (Унаследовано от CollectionView) |
| CommitEdit() |
Завершает транзакцию редактирования и сохраняет ожидающие изменения. |
| CommitNew() |
Завершает операцию добавления и сохраняет ожидающий новый элемент. |
| Compare(Object, Object) |
Сравнивает два объекта и возвращает значение, указывающее, меньше ли одно, равно или больше другого. |
| Contains(Object) |
Возвращает значение, указывающее, принадлежит ли данный элемент представлению коллекции. |
| DeferRefresh() |
Вводит цикл отложения, который можно использовать для слияния изменений в представлении и задержке автоматического обновления. (Унаследовано от CollectionView) |
| DetachFromSourceCollection() |
Удаляет ссылку на базовую коллекцию из .CollectionView (Унаследовано от CollectionView) |
| EditItem(Object) |
Начинает транзакцию редактирования указанного элемента. |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetEnumerator() |
Возвращает объект, который можно использовать для перечисления элементов в представлении. |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetItemAt(Int32) |
Извлекает элемент по указанной позиции в представлении. |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| IndexOf(Object) |
Возвращает индекс, в котором данный элемент данных принадлежит коллекции, или -1, если индекс этого элемента неизвестен. |
| InternalContains(Object) |
Возвращает значение, указывающее, содержит ли InternalList элемент. |
| InternalGetEnumerator() |
Возвращает перечислитель для объекта InternalList. |
| InternalIndexOf(Object) |
Возвращает индекс указанного элемента в элементе InternalList. |
| InternalItemAt(Int32) |
Возвращает элемент по заданному индексу в объекте InternalList. |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| MoveCurrentTo(Object) |
Задает указанный элемент, который будет находиться CurrentItem в представлении. (Унаследовано от CollectionView) |
| MoveCurrentToFirst() |
Задает первый элемент в представлении CurrentItemв качестве элемента . (Унаследовано от CollectionView) |
| MoveCurrentToLast() |
Задает последний элемент в представлении CurrentItemв качестве элемента . (Унаследовано от CollectionView) |
| MoveCurrentToNext() |
Задает элемент после CurrentItem представления в качестве CurrentItemэлемента. (Унаследовано от CollectionView) |
| MoveCurrentToPosition(Int32) |
Задает элемент по указанному индексу CurrentItem в представлении. |
| MoveCurrentToPrevious() |
Задает элемент перед CurrentItem представлением в качестве CurrentItemэлемента. (Унаследовано от CollectionView) |
| OKToChangeCurrent() |
Возвращает значение, указывающее, может ли представление изменить элемент.CurrentItem (Унаследовано от CollectionView) |
| OnAllowsCrossThreadChangesChanged() |
Происходит при AllowsCrossThreadChanges изменении свойства. |
| OnBeginChangeLogging(NotifyCollectionChangedEventArgs) |
Устаревшие..
Вызывается базовым классом, чтобы уведомить производный класс о том, что CollectionChanged событие было отправлено в очередь сообщений. |
| OnCollectionChanged(NotifyCollectionChangedEventArgs) |
Вызывает событие CollectionChanged. (Унаследовано от CollectionView) |
| OnCollectionChanged(Object, NotifyCollectionChangedEventArgs) |
Вызывает событие CollectionChanged. (Унаследовано от CollectionView) |
| OnCurrentChanged() |
Вызывает событие CurrentChanged. (Унаследовано от CollectionView) |
| OnCurrentChanging() |
CurrentChanging Вызывает событие, которое не может быть отменено. (Унаследовано от CollectionView) |
| OnCurrentChanging(CurrentChangingEventArgs) |
CurrentChanging Вызывает событие с указанными аргументами. (Унаследовано от CollectionView) |
| OnPropertyChanged(PropertyChangedEventArgs) |
PropertyChanged Вызывает событие с помощью указанных аргументов. (Унаследовано от CollectionView) |
| PassesFilter(Object) |
Возвращает значение, указывающее, принадлежит ли указанный элемент в базовой коллекции представлению. |
| ProcessCollectionChanged(NotifyCollectionChangedEventArgs) |
CollectionChanged Обрабатывает события. |
| ProcessPendingChanges() |
Гарантирует, что все ожидающие изменения в коллекции зафиксированы. (Унаследовано от CollectionView) |
| Refresh() |
Повторно создает представление. (Унаследовано от CollectionView) |
| RefreshOrDefer() |
Обновляет представление или указывает, что представление должно обновляться при завершении цикла отложения. (Унаследовано от CollectionView) |
| RefreshOverride() |
Повторно создает представление. |
| Remove(Object) |
Удаляет указанный элемент из коллекции. |
| RemoveAt(Int32) |
Удаляет элемент в указанной позиции из коллекции. |
| SetCurrent(Object, Int32, Int32) |
Задает указанный элемент и индекс в качестве значений CurrentItem и CurrentPosition свойств. Этот метод можно вызвать из конструктора производного класса. (Унаследовано от CollectionView) |
| SetCurrent(Object, Int32) |
Задает указанный элемент и индекс в качестве значений CurrentItem и CurrentPosition свойств. (Унаследовано от CollectionView) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
| VerifyAccess() |
Принудительно применяет, что вызывающий поток имеет доступ к этому DispatcherObject. (Унаследовано от DispatcherObject) |
События
| Имя | Описание |
|---|---|
| CollectionChanged |
Происходит при изменении представления. (Унаследовано от CollectionView) |
| CurrentChanged |
Происходит после CurrentItem изменения. (Унаследовано от CollectionView) |
| CurrentChanging |
Происходит при CurrentItem изменении. (Унаследовано от CollectionView) |
| PropertyChanged |
Происходит при изменении значения свойства. (Унаследовано от CollectionView) |
Явные реализации интерфейса
| Имя | Описание |
|---|---|
| IComparer.Compare(Object, Object) |
Этот член поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначен для использования непосредственно из кода. |
| IEnumerable.GetEnumerator() |
IEnumerator Возвращает объект, который можно использовать для перечисления элементов в представлении. (Унаследовано от CollectionView) |
| INotifyCollectionChanged.CollectionChanged |
Происходит при изменении представления. (Унаследовано от CollectionView) |
| INotifyPropertyChanged.PropertyChanged |
Появляется при изменении значения свойства. (Унаследовано от CollectionView) |
Методы расширения
| Имя | Описание |
|---|---|
| AsParallel(IEnumerable) |
Включает параллелизацию запроса. |
| AsQueryable(IEnumerable) |
Преобразует IEnumerable в IQueryable. |
| Cast<TResult>(IEnumerable) |
Приведение элементов IEnumerable к указанному типу. |
| OfType<TResult>(IEnumerable) |
Фильтрует элементы IEnumerable на основе указанного типа. |