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. |
OnAllowsCrossThreadChangesChanged() |
Происходит при изменении свойства AllowsCrossThreadChanges. (Унаследовано от CollectionView) |
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) |
Установка заданного элемента и индекса в качестве значений свойств CurrentItem и CurrentPosition. (Унаследовано от CollectionView) |
SetCurrent(Object, Int32, 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) |
Методы расширения
Cast<TResult>(IEnumerable) |
Приводит элементы объекта IEnumerable к заданному типу. |
OfType<TResult>(IEnumerable) |
Выполняет фильтрацию элементов объекта IEnumerable по заданному типу. |
AsParallel(IEnumerable) |
Позволяет осуществлять параллельный запрос. |
AsQueryable(IEnumerable) |
Преобразовывает коллекцию IEnumerable в объект IQueryable. |