DependencyObjectCollection Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Implémente une classe de collection pratique qui peut contenir des éléments 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)- Héritage
- Attributs
- Implémente
Configuration requise pour Windows
| Famille d’appareils |
Windows 10 (introduit dans 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduit dans v1.0)
|
Remarques
L’objectif de la classe DependencyObjectCollection est principalement de prendre en charge les outils et la portabilité des comportements. Les comportements sont une technique permettant de définir certaines interactions de base d’un élément d’interface utilisateur entièrement en XAML, sans nécessiter de gestionnaire d’événements et de code-behind.
Si vous souhaitez implémenter une classe d’objets métier qui prend en charge les notifications modifiées par la collection, vous devez utiliser ObservableCollection ou l’un des modèles d’interface qui prend en charge les événements modifiés. Pour plus d’informations, consultez Liaison de données en détail.
Énumération de la collection en C# ou Microsoft Visual Basic
Un DependencyObjectCollection étant énumérable, vous pouvez utiliser une syntaxe spécifique au langage, telle que foreach en C# pour énumérer les éléments de la collection. Le compilateur effectue le casting de type pour vous et vous n’aurez pas besoin de caster IEnumerable<DependencyObject> explicitement. Si vous avez besoin d’un cast explicite, par exemple si vous souhaitez appeler GetEnumerator, effectuez un cast en IEnumerable<T> avec une contrainte DependencyObject .
Constructeurs
| DependencyObjectCollection() |
Initialise une nouvelle instance de la classe DependencyObjectCollection. |
Propriétés
| Dispatcher |
Obtient le CoreDispatcher auquel cet objet est associé. CoreDispatcher représente une installation qui peut accéder à DependencyObject sur le thread d’interface utilisateur, même si le code est initié par un thread autre que l’interface utilisateur. (Hérité de DependencyObject) |
| Size |
Obtient la taille (nombre) de la collection. |
Méthodes
| Append(DependencyObject) |
Ajoute un nouvel élément à la collection. |
| Clear() |
Supprime tous les éléments de la collection. |
| ClearValue(DependencyProperty) |
Efface la valeur locale d’une propriété de dépendance. (Hérité de DependencyObject) |
| First() |
Retourne l’itérateur pour l’itération sur les éléments de la collection. |
| GetAnimationBaseValue(DependencyProperty) |
Retourne toute valeur de base établie pour une propriété de dépendance, qui s’applique dans les cas où une animation n’est pas active. (Hérité de DependencyObject) |
| GetAt(UInt32) |
Retourne l’objet DependencyObject situé à l’index spécifié. |
| GetMany(UInt32, DependencyObject[]) |
Récupère plusieurs éléments en un seul passage par l’itérateur. |
| GetValue(DependencyProperty) |
Retourne la valeur effective actuelle d’une propriété de dépendance à partir d’un objet DependencyObject. (Hérité de DependencyObject) |
| GetView() |
Obtient une vue immuable dans la collection. |
| IndexOf(DependencyObject, UInt32) |
Récupère l’index de l’élément spécifié. |
| InsertAt(UInt32, DependencyObject) |
Insère l’élément spécifié à l’index spécifié. |
| ReadLocalValue(DependencyProperty) |
Retourne la valeur locale d’une propriété de dépendance, si une valeur locale est définie. (Hérité de DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Inscrit une fonction de notification pour écouter les modifications apportées à un DependencyProperty spécifique sur ce instance DependencyObject. (Hérité de DependencyObject) |
| RemoveAt(UInt32) |
Supprime l'élément à l'index spécifié. |
| RemoveAtEnd() |
Supprime le dernier élément de la collection. |
| ReplaceAll(DependencyObject[]) |
Efface initialement la collection, puis insère le tableau fourni en tant que nouveaux éléments. |
| SetAt(UInt32, DependencyObject) |
Définit la valeur au niveau de l’index spécifié sur la valeur DependencyObject spécifiée. |
| SetValue(DependencyProperty, Object) |
Définit la valeur locale d’une propriété de dépendance sur un DependencyObject. (Hérité de DependencyObject) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Annule une notification de modification précédemment inscrite en appelant RegisterPropertyChangedCallback. (Hérité de DependencyObject) |
Événements
| VectorChanged |
Se produit lorsque le contenu de la collection change. |