DependencyObjectCollection Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.UI.Xaml

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Implementa una classe di raccolta pratica che può contenere elementi DependencyObject .

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DependencyObjectCollection : DependencyObject, IIterable<DependencyObject>, IObservableVector<DependencyObject>, IVector<DependencyObject>

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class DependencyObjectCollection : DependencyObject, IEnumerable<DependencyObject>, IList<DependencyObject>, IObservableVector<DependencyObject>

Public Class DependencyObjectCollection
Inherits DependencyObject
Implements IEnumerable(Of DependencyObject), IList(Of DependencyObject), IObservableVector(Of DependencyObject)

Ereditarietà: Object IInspectable DependencyObject DependencyObjectCollection

Attributi: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni: IIterable<T> IEnumerable<T> IIterable<DependencyObject> IEnumerable<DependencyObject> IVector<T> IList<T> IVector<DependencyObject> IList<DependencyObject> IObservableVector<DependencyObject>

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Lo scopo della classe DependencyObjectCollection è principalmente quello di supportare lo strumento e la portabilità dei comportamenti. I comportamenti sono una tecnica per definire determinate interazioni di base di un elemento dell'interfaccia utente interamente in XAML, senza richiedere un gestore eventi e un code-behind.

Se si è interessati a implementare una classe di oggetti business che supporta le notifiche modificate dalla raccolta, è consigliabile usare ObservableCollection o uno dei modelli di interfaccia che supporta gli eventi modificati. Per altre informazioni, vedere Data binding in profondità.

Enumerazione della raccolta in C# o Microsoft Visual Basic

Un oggetto DependencyObjectCollection è enumerabile, quindi è possibile usare una sintassi specifica del linguaggio, ad esempio foreach in C# per enumerare gli elementi nella raccolta. Il compilatore esegue il cast di tipi per l'utente e non è necessario eseguire il cast IEnumerable<DependencyObject> in modo esplicito. Se è necessario eseguire il cast in modo esplicito, ad esempio se si vuole chiamare GetEnumerator, eseguire il cast in IEnumerable<T> con un vincolo DependencyObject .

Costruttori

DependencyObjectCollection()

Inizializza una nuova istanza della classe DependencyObjectCollection .

Proprietà

Dispatcher	Ottiene CoreDispatcher associato a questo oggetto. CoreDispatcher rappresenta una struttura che può accedere a DependencyObject nel thread dell'interfaccia utente anche se il codice viene avviato da un thread non interfaccia utente. (Ereditato da DependencyObject)
Size	Ottiene le dimensioni (conteggio) dell'insieme.

Metodi

Append(DependencyObject)	Aggiunge un nuovo elemento alla raccolta.
Clear()	Rimuove tutti gli elementi dalla raccolta.
ClearValue(DependencyProperty)	Cancella il valore locale di una proprietà di dipendenza. (Ereditato da DependencyObject)
First()	Restituisce l'iteratore per l'iterazione sugli elementi della raccolta.
GetAnimationBaseValue(DependencyProperty)	Restituisce qualsiasi valore di base stabilito per una proprietà di dipendenza, che si applica nei casi in cui un'animazione non è attiva. (Ereditato da DependencyObject)
GetAt(UInt32)	Restituisce l'oggetto DependencyObject situato nell'indice specificato.
GetMany(UInt32, DependencyObject[])	Recupera più elementi in un singolo passaggio dell'iteratore.
GetValue(DependencyProperty)	Restituisce il valore effettivo corrente di una proprietà di dipendenza da un oggetto DependencyObject. (Ereditato da DependencyObject)
GetView()	Ottiene una visualizzazione non modificabile nella raccolta.
IndexOf(DependencyObject, UInt32)	Recupera l'indice dell'elemento specificato.
InsertAt(UInt32, DependencyObject)	Inserisce l'elemento specificato nell'indice specificato.
ReadLocalValue(DependencyProperty)	Restituisce il valore locale di una proprietà di dipendenza, se viene impostato un valore locale. (Ereditato da DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registra una funzione di notifica per l'ascolto delle modifiche a un'istanza di DependencyObject specifica. (Ereditato da DependencyObject)
RemoveAt(UInt32)	Rimuove l'elemento all'indice specificato.
RemoveAtEnd()	Rimuove l'ultimo elemento della raccolta.
ReplaceAll(DependencyObject[])	Inizialmente cancella la raccolta, quindi inserisce la matrice fornita come nuovi elementi.
SetAt(UInt32, DependencyObject)	Imposta il valore in corrispondenza dell'indice specificato sul valore DependencyObject specificato.
SetValue(DependencyProperty, Object)	Imposta il valore locale di una proprietà di dipendenza in un oggetto DependencyObject. (Ereditato da DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Annulla una notifica di modifica registrata in precedenza chiamando RegisterPropertyChangedCallback. (Ereditato da DependencyObject)

Eventi

VectorChanged

Si verifica quando il contenuto della raccolta cambia.

Si applica a