DependencyObjectCollection Classe
Definizione
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.
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à
- Attributi
- Implementazioni
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. |