ListCollectionView Класс

Определение

Отражает представление коллекции для коллекций, которые реализуют класс IList.Represents the collection view for collections that implement IList.

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.ICollectionViewLiveShaping, System.ComponentModel.IEditableCollectionViewAddNewItem, System.ComponentModel.IItemProperties
type ListCollectionView = class
    inherit CollectionView
    interface IComparer
    interface IEditableCollectionViewAddNewItem
    interface IEditableCollectionView
    interface ICollectionViewLiveShaping
    interface IItemProperties
Public Class ListCollectionView
Inherits CollectionView
Implements ICollectionViewLiveShaping, IComparer, IEditableCollectionViewAddNewItem, IItemProperties
Наследование
Реализации

Комментарии

При привязке к коллекции данных может потребоваться сортировка, фильтрация или группирование данных.When you bind to a data collection, you may want to sort, filter, or group the data. Для этого используются представления коллекций.To do that, you use collection views. Можно представить CollectionView как слой поверх исходной коллекции привязки, позволяющий просматривать и отображать исходную коллекцию на основе запросов сортировки, фильтрации и группирования, без необходимости управлять самой исходной коллекцией.You can think of a CollectionView as the layer on top of the binding source collection that allows you to navigate and display the source collection based on sort, filter, and group queries, all without having to manipulate the underlying source collection itself. Если исходная коллекция реализует INotifyCollectionChanged интерфейс, то изменения, вызванные CollectionChanged этим событием, передаются в представления.If the source collection implements the INotifyCollectionChanged interface, the changes raised by the CollectionChanged event are propagated to the views.

Все коллекции имеют значение по CollectionViewумолчанию.All collections have a default CollectionView. Для всех коллекций ListCollectionView , IListреализующих, объект является объектом представления по умолчанию.For all collections implementing IList, the ListCollectionView object is the default view object. — Это класс представления коллекции, используемый для коллекций, реализующих IBindingList. BindingListCollectionViewThe BindingListCollectionView is the collection view class used for collections that implement IBindingList. Чтобы получить представление по умолчанию, используйте GetDefaultView метод.To get the default view, you use the GetDefaultView method. Пример см. в статье Практическое руководство. Возвращает представление коллекцииданных по умолчанию.For an example, see How to: Get the Default View of a Data Collection.

Дополнительные сведения о представлениях коллекций см. в разделе Общие сведения о привязке данных.For more information about collection views, see Data Binding Overview.

Конструкторы

ListCollectionView(IList)

Инициализирует новый экземпляр класса ListCollectionView с использованием предоставленной коллекции, которая реализует интерфейс IList.Initializes a new instance of the ListCollectionView class, using a supplied collection that implements IList.

Свойства

ActiveComparer

Возвращает или задает текущий активный компаратор, который используется при сортировке.Gets or sets the current active comparer that is used in sorting.

ActiveFilter

Возвращает или задает обратный вызов текущего активного свойства Filter.Gets or sets the current active Filter callback.

AllowsCrossThreadChanges

Получает значение, указывающее, может ли какой-либо поток, кроме создавшего CollectionView, изменить SourceCollection.Gets a value that indicates whether a thread other than the one that created the CollectionView can change the SourceCollection.

(Унаследовано от CollectionView)
CanAddNew

Возвращает значение, указывающее, можно ли добавить новый элемент в коллекцию.Gets a value that indicates whether a new item can be added to the collection.

CanAddNewItem

Получает значение, указывающее, можно ли добавить указанный объект в коллекцию.Gets a value that indicates whether a specified object can be added to the collection.

CanCancelEdit

Возвращает значение, указывающее, может ли представление коллекции отклонить отложенные изменения и восстановить исходные значения изменяемого объекта.Gets a value that indicates whether the collection view can discard pending changes and restore the original values of an edited object.

CanChangeLiveFiltering

Получает значение, указывающее, поддерживает ли представление коллекции включение или выключение фильтрации данных в режиме реального времени.Gets a value that indicates whether the collection view supports turning filtering data in real time on or off.

CanChangeLiveGrouping

Получает значение, указывающее, поддерживает ли представление коллекции включение или выключение группирования данных в режиме реального времени.Gets a value that indicates whether the collection view supports turning grouping data in real time on or off.

CanChangeLiveSorting

Получает значение, указывающее, поддерживает ли представление коллекции включение или выключение сортировки данных в режиме реального времени.Gets a value that indicates whether the collection view supports turning sorting data in real time on or off.

CanFilter

Получает значение, указывающее, поддерживает ли представление фильтрацию, основанную на обратных вызовах.Gets a value that indicates whether the view supports callback-based filtering.

CanGroup

Получает значение, которое указывает, поддерживает ли это представление коллекции группирование.Gets a value that indicates whether the collection view supports grouping.

CanRemove

Возвращает значение, указывающее, можно ли удалить элемент из коллекции.Gets a value that indicates whether an item can be removed from the collection.

CanSort

Получает значение, которое указывает, поддерживает ли представление коллекции сортировку.Gets a value that indicates whether the collection view supports sorting.

Comparer

Возврат объекта, который можно использовать для сравнения элементов представления.Returns an object that you can use to compare items in the view.

(Унаследовано от CollectionView)
Count

Получает оценочное количество записей.Gets the estimated number of records.

Culture

Возвращает или задает сведений о языке и региональных параметрах, используемых в ходе сортировки.Gets or sets the culture information to use during sorting.

(Унаследовано от CollectionView)
CurrentAddItem

Возвращает элемент, добавляемый во время текущей транзакции добавления.Gets the item that is being added during the current add transaction.

CurrentEditItem

Получает элемент в редактируемой коллекции.Gets the item in the collection that is being edited.

CurrentItem

Возвращает текущий элемент в представлении.Gets the current item in the view.

(Унаследовано от CollectionView)
CurrentPosition

Получение порядкового номера CurrentItem в рамках представления (возможна сортировка и фильтрация).Gets the ordinal position of the CurrentItem within the (optionally sorted and filtered) view.

(Унаследовано от CollectionView)
CustomSort

Возвращает или задает настраиваемый объект, который реализует интерфейс IComparer, для сортировки элементов в представлении.Gets or sets a custom object that implements IComparer to sort items in the view.

Dispatcher

Возвращает объект Dispatcher, с которым связан этот объект DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Унаследовано от DispatcherObject)
Filter

Получает или задает метод, используемый для определения, подходит ли элемент для включения в представление.Gets or sets a method that is used to determine whether an item is suitable for inclusion in the view.

GroupBySelector

Возвращает или задает делегата, выбирающего GroupDescription как функцию родительской группы и ее уровень.Gets or sets a delegate to select the GroupDescription as a function of the parent group and its level.

GroupDescriptions

Получает коллекцию объектов GroupDescription, которые описывают группировку элементов коллекции в представлении.Gets a collection of GroupDescription objects that describe how the items in the collection are grouped in the view.

Groups

Возвращает группы верхнего уровня.Gets the top-level groups.

InternalCount

Получает количество записей в списке InternalList.Gets the number of records in the InternalList.

InternalList

Возвращает отфильтрованный и отсортированный список элементов.Gets the filtered and sorted list of items.

IsAddingNew

Получает значение, указывающее, выполняется ли в данный момент транзакция добавления.Gets a value that indicates whether an add transaction is in progress.

IsCurrentAfterLast

Возвращает значение, показывающее, находится ли элемент CurrentItem за концом коллекции.Gets a value that indicates whether the CurrentItem of the view is beyond the end of the collection.

(Унаследовано от CollectionView)
IsCurrentBeforeFirst

Получает значение, указывающее, находится ли элемент CurrentItem представления перед началом коллекции.Gets a value that indicates whether the CurrentItem of the view is before the beginning of the collection.

(Унаследовано от CollectionView)
IsCurrentInSync

Получение значения, которое определяет, находится ли CurrentItem в CurrentPosition.Gets a value that indicates whether the CurrentItem is at the CurrentPosition.

(Унаследовано от CollectionView)
IsDataInGroupOrder

Возвращает или задает значение, указывающее, находится ли список элементов (после применения сортировки и фильтров, если такие имеются) в правильном порядке для группировки.Gets or sets a value that indicates whether the list of items (after applying the sort and filters, if any) is already in the correct order for grouping.

IsDynamic

Получение значения, определяющего, предоставляет ли базовая коллекция уведомления об изменениях.Gets a value that indicates whether the underlying collection provides change notifications.

(Унаследовано от CollectionView)
IsEditingItem

Получает значение, указывающее, выполняется ли в данный момент транзакция редактирования.Gets a value that indicates whether an edit transaction is in progress.

IsEmpty

Возвращает значение, указывающее, является ли результирующее (отфильтрованное) представление пустым.Returns a value that indicates whether the resulting (filtered) view is empty.

IsGrouping

Получает представление, которое указывает, есть ли группы в представлении.Gets a value that indicates whether there are groups in the view.

IsInUse

Получает значение, указывающее, подписывается ли какой-либо объект на события этого CollectionView.Gets a value that indicates whether any object is subscribing to the events of this CollectionView.

(Унаследовано от CollectionView)
IsLiveFiltering

Получает или задает значение, указывающее, включена ли фильтрация данных в реальном времени.Gets or sets a value that indicates whether filtering data in real time is enabled.

IsLiveGrouping

Получает или задает значение, указывающее, включено ли группирование данных в реальном времени.Gets or sets a value that indicates whether grouping data in real time is enabled.

IsLiveSorting

Получает или задает значение, указывающее, включена ли сортировка в реальном времени.Gets or sets a value that indicates whether sorting in real time is enabled.

IsRefreshDeferred

Получает значение, которое указывает, используется ли метод DeferRefresh().Gets a value that indicates whether there is an outstanding DeferRefresh() in use.

(Унаследовано от CollectionView)
ItemProperties

Получает коллекцию объектов, описывающих свойства элементов коллекции.Gets a collection of objects that describes the properties of the items in the collection.

LiveFilteringProperties

Получает коллекцию строк, определяющих свойства, которые участвуют в фильтрации данных в режиме реального времени.Gets a collection of strings that specify the properties that participate in filtering data in real time.

LiveGroupingProperties

Получает коллекцию строк, определяющих свойства, которые участвуют в группировании данных в режиме реального времени.Gets a collection of strings that specify the properties that participate in grouping data in real time.

LiveSortingProperties

Получает коллекцию строк, определяющих свойства, которые участвуют в сортировке данных в режиме реального времени.Gets a collection of strings that specify the properties that participate in sorting data in real time.

NeedsRefresh

Получение значения, которое определяет, необходимо ли обновление представлению.Gets a value that indicates whether the view needs to be refreshed.

(Унаследовано от CollectionView)
NewItemPlaceholderPosition

Получает или задает положение заполнителя нового элемента в ListCollectionView.Gets or sets the position of the new item placeholder in the ListCollectionView.

SortDescriptions

Возвращает коллекцию объектов SortDescription, описывающую, как элементы коллекции сортируются в представлении.Gets a collection of SortDescription objects that describes how the items in the collection are sorted in the view.

SourceCollection

Возврат базовой неотфильтрованной коллекции.Returns the underlying unfiltered collection.

(Унаследовано от CollectionView)
UpdatedOutsideDispatcher

Получение значения, определяющего, стоит ли обновлять журнал записей из-за получения уведомления CollectionChanged по другому потоку, не вводя сперва в диспетчер потока пользовательский интерфейсuser interface (UI).Gets a value that indicates whether it has been necessary to update the change log because a CollectionChanged notification has been received on a different thread without first entering the пользовательский интерфейсuser interface (UI) thread dispatcher.

(Унаследовано от CollectionView)
UsesLocalArray

Получает значение, которое указывает, требуется ли для сортировки и фильтрации закрытая копия данных.Gets a value that indicates whether a private copy of the data is needed for sorting and filtering.

Методы

AddNew()

Запускает транзакцию добавления и возвращает ожидающий новый элемент.Starts an add transaction and returns the pending new item.

AddNewItem(Object)

Добавляет указанный объект в коллекцию.Adds the specified object to the collection.

CancelEdit()

Завершает транзакцию редактирования и, если это возможно, восстанавливает исходное значение для элемента.Ends the edit transaction, and if possible, restores the original value to the item.

CancelNew()

Завершает транзакцию добавления и отменяет ожидающий новый элемент.Ends the add transaction and discards the pending new item.

CheckAccess()

Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Унаследовано от DispatcherObject)
ClearChangeLog()

Очищение ожидающих изменений из журнала измененийClears any pending changes from the change log.

(Унаследовано от CollectionView)
ClearPendingChanges()

Очищает необработанные изменения в коллекцию.Clears unprocessed changed to the collection.

(Унаследовано от CollectionView)
CommitEdit()

Завершает транзакцию изменения и сохраняет отложенные изменения.Ends the edit transaction and saves the pending changes.

CommitNew()

Завершает транзакцию добавления и сохраняет ожидаемый новый элемент.Ends the add transaction and saves the pending new item.

Compare(Object, Object)

Сравнивает два объекта и возвращает значение, которое указывает, равны ли эти объекты или один из них больше другого.Compares two objects and returns a value that indicates whether one is less than, equal to, or greater than the other.

Contains(Object)

Возвращает значение, показывающее, принадлежит ли данный элемент этому представлению коллекции.Returns a value that indicates whether a given item belongs to the collection view.

DeferRefresh()

Вводит отложенный цикл, который можно использовать для слияния изменений с представлением и задержки автоматического обновления.Enters a defer cycle that you can use to merge changes to the view and delay automatic refresh.

(Унаследовано от CollectionView)
DetachFromSourceCollection()

Удаляет ссылку на базовую коллекцию из CollectionView.Removes the reference to the underlying collection from the CollectionView.

(Унаследовано от CollectionView)
EditItem(Object)

Начинает транзакцию редактирования заданного элемента.Begins an edit transaction of the specified item.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetEnumerator()

Возврат объекта, который можно использовать для перечисления элементов представления.Returns an object that you can use to enumerate the items in the view.

GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetItemAt(Int32)

Извлекает элемент по заданной позиции в представлении.Retrieves the item at the specified position in the view.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
IndexOf(Object)

Возвращает индекс элемента данных в коллекции или значение -1, если индекс этого элемента неизвестен.Returns the index where the given data item belongs in the collection, or -1 if the index of that item is unknown.

InternalContains(Object)

Возвращает значение, которое указывает, содержит ли свойство InternalList этот элемент.Return a value that indicates whether the InternalList contains the item.

InternalGetEnumerator()

Возвращает перечислитель для коллекции InternalList.Returns an enumerator for the InternalList.

InternalIndexOf(Object)

Возвращает индекс заданного элемента в списке InternalList.Returns the index of the specified item in the InternalList.

InternalItemAt(Int32)

Возвращает индекс заданного элемента в списке InternalList.Returns the item at the given index in the InternalList.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
MoveCurrentTo(Object)

Задает указанный элемент в качестве свойства CurrentItem в представлении.Sets the specified item to be the CurrentItem in the view.

(Унаследовано от CollectionView)
MoveCurrentToFirst()

Задает первый элемент в представлении в качестве CurrentItem.Sets the first item in the view as the CurrentItem.

(Унаследовано от CollectionView)
MoveCurrentToLast()

Задает последний элемент в представлении в качестве CurrentItem.Sets the last item in the view as the CurrentItem.

(Унаследовано от CollectionView)
MoveCurrentToNext()

Задает элемент после CurrentItem в представлении в качестве элемента CurrentItem.Sets the item after the CurrentItem in the view as the CurrentItem.

(Унаследовано от CollectionView)
MoveCurrentToPosition(Int32)

Задает элемент по заданному индексу в качестве CurrentItem в представлении.Sets the item at the specified index to be the CurrentItem in the view.

MoveCurrentToPrevious()

Устанавливает элемент перед элементом CurrentItem в качестве CurrentItem.Sets the item before the CurrentItem in the view as the CurrentItem.

(Унаследовано от CollectionView)
OKToChangeCurrent()

Возвращение значения, которое определяет, может ли представление менять то, какой элемент является CurrentItem.Returns a value that indicates whether the view can change which item is the CurrentItem.

(Унаследовано от CollectionView)
OnAllowsCrossThreadChangesChanged()

Происходит при изменении свойства AllowsCrossThreadChanges.Occurs when the AllowsCrossThreadChanges property changes.

OnBeginChangeLogging(NotifyCollectionChangedEventArgs)

Вызывается базовым классом, чтобы уведомить производный класс о помещении события CollectionChanged в очередь сообщений.Called by the base class to notify the derived class that a CollectionChanged event has been posted to the message queue.

OnCollectionChanged(NotifyCollectionChangedEventArgs)

Вызывает событие CollectionChanged.Raises the CollectionChanged event.

(Унаследовано от CollectionView)
OnCollectionChanged(Object, NotifyCollectionChangedEventArgs)

Вызывает событие CollectionChanged.Raises the CollectionChanged event.

(Унаследовано от CollectionView)
OnCurrentChanged()

Вызывает событие CurrentChanged.Raises the CurrentChanged event.

(Унаследовано от CollectionView)
OnCurrentChanging()

Порождение события CurrentChanging, которое не подлежит отмене.Raises a CurrentChanging event that is not cancelable.

(Унаследовано от CollectionView)
OnCurrentChanging(CurrentChangingEventArgs)

Порождение события CurrentChanging посредством заданных аргументов.Raises the CurrentChanging event with the specified arguments.

(Унаследовано от CollectionView)
OnPropertyChanged(PropertyChangedEventArgs)

Порождение события PropertyChanged с помощью заданных аргументов.Raises the PropertyChanged event using the specified arguments.

(Унаследовано от CollectionView)
PassesFilter(Object)

Возврат значения, определяющего, принадлежит ли заданный элемент в базовой коллекции представлению.Returns a value that indicates whether the specified item in the underlying collection belongs to the view.

ProcessCollectionChanged(NotifyCollectionChangedEventArgs)

Выполняет обработку событий CollectionChanged.Handles CollectionChanged events.

ProcessPendingChanges()

Гарантирует, что были зафиксированы все ожидающие изменения в коллекции.Ensures that all pending changes to the collection have been committed.

(Унаследовано от CollectionView)
Refresh()

Повторное создание представления.Re-creates the view.

(Унаследовано от CollectionView)
RefreshOrDefer()

Обновление представления или указание на необходимость обновления представления после завершения отложенного цикла.Refreshes the view or specifies that the view needs to be refreshed when the defer cycle completes.

(Унаследовано от CollectionView)
RefreshOverride()

Воссоздает представление.Recreates the view.

Remove(Object)

Удаляет заданный элемент из коллекции.Removes the specified item from the collection.

RemoveAt(Int32)

Удаляет элемент в указанной позиции из коллекции.Removes the item at the specified position from the collection.

SetCurrent(Object, Int32)

Установка заданного элемента и индекса в качестве значений свойств CurrentItem и CurrentPosition.Sets the specified item and index as the values of the CurrentItem and CurrentPosition properties.

(Унаследовано от CollectionView)
SetCurrent(Object, Int32, Int32)

Установка заданного элемента и индекса в качестве значений свойств CurrentItem и CurrentPosition.Sets the specified item and index as the values of the CurrentItem and CurrentPosition properties. Данный метод можно вызвать из конструктора производного класса.This method can be called from a constructor of a derived class.

(Унаследовано от CollectionView)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)
VerifyAccess()

Обеспечивает наличие у вызывающего потока доступ к этому DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Унаследовано от DispatcherObject)

События

CollectionChanged

Происходит при изменении представления.Occurs when the view has changed.

(Унаследовано от CollectionView)
CurrentChanged

Происходит после изменения CurrentItem.Occurs after the CurrentItem has changed.

(Унаследовано от CollectionView)
CurrentChanging

Происходит, когда CurrentItem меняется.Occurs when the CurrentItem is changing.

(Унаследовано от CollectionView)
PropertyChanged

Происходит при изменении значения свойства.Occurs when a property value has changed.

(Унаследовано от CollectionView)

Явные реализации интерфейса

IComparer.Compare(Object, Object)

Этот член поддерживает инфраструктуру Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) и не предназначен для непосредственного использования из кода.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

IEnumerable.GetEnumerator()

Возврат объекта IEnumerator, который можно использовать для перечисления элементов представления.Returns an IEnumerator object that you can use to enumerate the items in the view.

(Унаследовано от CollectionView)
INotifyCollectionChanged.CollectionChanged

Происходит при изменении представления.Occurs when the view has changed.

(Унаследовано от CollectionView)
INotifyPropertyChanged.PropertyChanged

Возникает при смене значения свойства.Occurs when a property value changes.

(Унаследовано от CollectionView)

Методы расширения

Cast<TResult>(IEnumerable)

Приводит элементы объекта IEnumerable к заданному типу.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Позволяет осуществлять параллельный запрос.Enables parallelization of a query.

AsQueryable(IEnumerable)

Преобразовывает коллекцию IEnumerable в объект IQueryable.Converts an IEnumerable to an IQueryable.

Применяется к