CollectionView Classe

Definizione

Spazio dei nomi:

System.Windows.Data

Assembly:

PresentationFramework.dll

Rappresenta una visualizzazione per il raggruppamento, l'ordinamento, il filtro e lo spostamento in una raccolta di dati.

public ref class CollectionView : System::Windows::Threading::DispatcherObject, System::Collections::IEnumerable, System::Collections::Specialized::INotifyCollectionChanged, System::ComponentModel::ICollectionView, System::ComponentModel::INotifyPropertyChanged

public class CollectionView : System.Windows.Threading.DispatcherObject, System.Collections.IEnumerable, System.Collections.Specialized.INotifyCollectionChanged, System.ComponentModel.ICollectionView, System.ComponentModel.INotifyPropertyChanged

type CollectionView = class
    inherit DispatcherObject
    interface IEnumerable
    interface INotifyCollectionChanged
    interface ICollectionView
    interface INotifyPropertyChanged

Public Class CollectionView
Inherits DispatcherObject
Implements ICollectionView, IEnumerable, INotifyCollectionChanged, INotifyPropertyChanged

Ereditarietà

Object

DispatcherObject

CollectionView

Derivato

System.Windows.Controls.ItemCollection

System.Windows.Data.BindingListCollectionView

System.Windows.Data.ListCollectionView

Implementazioni

IEnumerable INotifyCollectionChanged ICollectionView INotifyPropertyChanged

Commenti

Non è consigliabile creare oggetti di questa classe nel codice. Per creare una visualizzazione raccolta per una raccolta che implementa IEnumerablesolo , creare un CollectionViewSource oggetto , aggiungere la Source raccolta alla proprietà e ottenere la visualizzazione raccolta dalla View proprietà .

È possibile considerare una visualizzazione raccolta come un livello sopra una raccolta di origine di associazione che consente di esplorare e visualizzare la raccolta in base a query di ordinamento, filtro e gruppo, senza dover modificare la raccolta di origine sottostante stessa. Se la raccolta di origine implementa l'interfaccia INotifyCollectionChanged , le modifiche che generano l'evento CollectionChanged vengono propagate alle viste.

Poiché una vista non modifica la raccolta di origine sottostante, a una raccolta di origine possono essere associate più visualizzazioni. Usando le viste, è possibile visualizzare gli stessi dati in modi diversi. Ad esempio, è possibile utilizzare due visualizzazioni in una raccolta di Task oggetti per visualizzare le attività ordinate in base alla priorità in una parte della pagina e raggruppate in base all'area in un'altra parte della pagina.

Nelle applicazioni WPF tutte le raccolte hanno una visualizzazione raccolta predefinita associata. Anziché usare direttamente la raccolta, il motore di associazione accede sempre alla raccolta tramite la visualizzazione associata. Per ottenere la visualizzazione predefinita, usare il CollectionViewSource.GetDefaultView metodo . Una classe interna basata su CollectionView è la visualizzazione predefinita per le raccolte che implementano solo IEnumerable. ListCollectionView è la visualizzazione predefinita per le raccolte che implementano IList. BindingListCollectionView è la visualizzazione predefinita per le raccolte che implementano IBindingListView o IBindingList.

In alternativa, è possibile creare una visualizzazione della raccolta in XAML (Extensible Application Markup Language) usando la CollectionViewSource classe e quindi associare il controllo a tale visualizzazione. La CollectionViewSource classe è la rappresentazione XAML della CollectionView classe . Per un esempio, vedere Procedura: Ordinare e raggruppare i dati usando una visualizzazione in XAML.

Per altre informazioni, vedere "Binding a raccolte" in Panoramica del data binding.

Per impostare una visualizzazione in XAML, usare la CollectionViewSource classe . CollectionViewSource è la rappresentazione XAML della CollectionView classe ed espone i membri più usati della CollectionView classe .

Costruttori

CollectionView(IEnumerable)

Inizializza un'istanza nuova della classe CollectionView che rappresenta una visualizzazione dell'insieme specificato.

Proprietà

AllowsCrossThreadChanges	Ottiene un valore che indica se un thread diverso da quello che ha creato CollectionView può modificare SourceCollection.
CanFilter	Ottiene un valore che indica se la visualizzazione supporta il filtraggio.
CanGroup	Ottiene un valore che indica se la visualizzazione supporta il raggruppamento.
CanSort	Ottiene un valore che indica se la visualizzazione supporta l'ordinamento.
Comparer	Restituisce un oggetto che è possibile utilizzare per confrontare gli elementi nella visualizzazione.
Count	Ottiene il numero di record presenti nella visualizzazione.
Culture	Ottiene o imposta le informazioni sulle impostazioni cultura da utilizzare durante l'ordinamento.
CurrentItem	Ottiene l'elemento corrente della visualizzazione.
CurrentPosition	Ottiene la posizione ordinale dell'oggetto CurrentItem all'interno della visualizzazione (facoltativamente ordinata e filtrata).
Dispatcher	Ottiene l'oggetto Dispatcher associato a DispatcherObject. (Ereditato da DispatcherObject)
Filter	Ottiene o imposta un metodo usato per stabilire se un elemento è appropriato per l'inclusione nella visualizzazione.
GroupDescriptions	Ottiene un insieme di oggetti GroupDescription che descrive come sono raggruppati nella visualizzazione gli elementi dell'insieme.
Groups	Ottiene un insieme dei gruppi di livello superiore costruiti in base alla proprietà GroupDescriptions.
IsCurrentAfterLast	Ottiene un valore che indica se l'oggetto CurrentItem della visualizzazione è oltre la fine della raccolta.
IsCurrentBeforeFirst	Ottiene un valore che indica se l'oggetto CurrentItem della visualizzazione è prima dell'inizio della raccolta.
IsCurrentInSync	Ottiene un valore che indica se l'oggetto CurrentItem è nella posizione CurrentPosition.
IsDynamic	Ottiene un valore che indica se l'insieme sottostante fornisce notifiche di modifica.
IsEmpty	Ottiene un valore che indica se la visualizzazione risultante (filtrata) è vuota.
IsInUse	Ottiene un valore che indica se eventuali oggetti stanno effettuando la sottoscrizione all'oggetto CollectionView.
IsRefreshDeferred	Ottiene un valore che indica se è in uso l'oggetto DeferRefresh() in sospeso.
NeedsRefresh	Ottiene un valore che indica se la visualizzazione deve essere aggiornata.
NewItemPlaceholder	Ottiene l'oggetto che si trova nell'insieme per rappresentare un nuovo elemento.
SortDescriptions	Ottiene un insieme di oggetti SortDescription che descrivono come sono ordinati nella visualizzazione gli elementi dell'insieme.
SourceCollection	Restituisce l'insieme non filtrato sottostante.
UpdatedOutsideDispatcher	Ottiene un valore che indica se è stato necessario aggiornare il log delle modifiche perché è stata ricevuta una CollectionChanged notifica in un thread diverso senza prima immettere il dispatcher thread dell'interfaccia utente.

Metodi

CheckAccess()	Determina se il thread chiamante ha accesso a DispatcherObject. (Ereditato da DispatcherObject)
ClearChangeLog()	Obsoleti. Cancella qualsiasi modifica in sospeso dal registro delle modifiche.
ClearPendingChanges()	Cancella le modifiche non elaborate alla raccolta.
Contains(Object)	Restituisce un valore che indica se l'elemento specificato appartiene alla visualizzazione.
DeferRefresh()	Immette un ciclo di rinvio che è possibile utilizzare per unire le modifiche alla visualizzazione e ritardare l'aggiornamento automatico.
DetachFromSourceCollection()	Rimuove il riferimento alla raccolta sottostante da CollectionView.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetEnumerator()	Restituisce un oggetto che è possibile utilizzare per enumerare gli elementi nella visualizzazione.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetItemAt(Int32)	Recupera l'elemento in corrispondenza dell'indice in base zero specificato nella visualizzazione.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IndexOf(Object)	Restituisce l'indice nel quale si trova l'elemento specificato.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MoveCurrentTo(Object)	Imposta l'elemento specificato in modo che diventi l'oggetto CurrentItem nella visualizzazione.
MoveCurrentToFirst()	Imposta il primo elemento nella visualizzazione come CurrentItem.
MoveCurrentToLast()	Imposta l’ultimo elemento nella visualizzazione come CurrentItem.
MoveCurrentToNext()	Imposta l'elemento successivo a CurrentItem nella visualizzazione come CurrentItem.
MoveCurrentToPosition(Int32)	Imposta l'elemento in corrispondenza dell'indice specificato come primo oggetto CurrentItem nella visualizzazione.
MoveCurrentToPrevious()	Imposta l’elemento precedente a CurrentItem nella visualizzazione come CurrentItem.
OKToChangeCurrent()	Restituisce un valore che indica se la visualizzazione può modificare l'elemento CurrentItem.
OnAllowsCrossThreadChangesChanged()	Si verifica quando la proprietà AllowsCrossThreadChanges cambia.
OnBeginChangeLogging(NotifyCollectionChangedEventArgs)	Obsoleti. Chiamato dalla classe di base per notificare alla classe derivata che un evento CollectionChanged è stato inserito nella coda di messaggi.
OnCollectionChanged(NotifyCollectionChangedEventArgs)	Genera l'evento CollectionChanged.
OnCollectionChanged(Object, NotifyCollectionChangedEventArgs)	Genera l'evento CollectionChanged.
OnCurrentChanged()	Genera l'evento CurrentChanged.
OnCurrentChanging()	Genera un evento CurrentChanging che non è annullabile.
OnCurrentChanging(CurrentChangingEventArgs)	Genera l'evento CurrentChanging con gli argomenti specificati.
OnPropertyChanged(PropertyChangedEventArgs)	Genera l'evento PropertyChanged mediante gli argomenti specificati.
PassesFilter(Object)	Restituisce un valore che indica se l'elemento specificato nell'insieme sottostante appartiene alla visualizzazione.
ProcessCollectionChanged(NotifyCollectionChangedEventArgs)	Quando sottoposto a override in una classe derivata, elabora una singola modifica nel thread dell'interfaccia utente.
ProcessPendingChanges()	Verificare che tutte le modifiche in sospeso alla raccolta siano state salvate.
Refresh()	Ricrea la visualizzazione.
RefreshOrDefer()	Aggiorna la visualizzazione o specifica che la visualizzazione deve essere aggiornata al termine del ciclo di rinvio.
RefreshOverride()	Ricrea la visualizzazione.
SetCurrent(Object, Int32)	Imposta l'elemento specificato e l'indice come valori delle proprietà CurrentItem e CurrentPosition.
SetCurrent(Object, Int32, Int32)	Imposta l'elemento specificato e l'indice come valori delle proprietà CurrentItem e CurrentPosition. Questo metodo può essere richiamato da un costruttore di una classe derivata.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
VerifyAccess()	Impone che il thread chiamante abbia accesso a DispatcherObject. (Ereditato da DispatcherObject)

Eventi

CollectionChanged	Si verifica quando la vista viene modificata.
CurrentChanged	Si verifica dopo la modifica di CurrentItem.
CurrentChanging	Viene generato durante la modifica di un oggetto CurrentItem.
PropertyChanged	Si verifica quando il valore di una proprietà è stato modificato.

Implementazioni dell'interfaccia esplicita

IEnumerable.GetEnumerator()	Restituisce un oggetto IEnumerator che è possibile utilizzare per enumerare gli elementi nella visualizzazione.
INotifyCollectionChanged.CollectionChanged	Si verifica quando la vista viene modificata.
INotifyPropertyChanged.PropertyChanged	Generato quando il valore di una proprietà cambia.

Metodi di estensione