DependencyProperty Classe

Définition

Espace de noms:

System.Windows

Assembly:

WindowsBase.dll

Représente une propriété qui peut être définie par le biais de méthodes telles que le style, la liaison de données, l’animation et l’héritage.

public ref class DependencyProperty sealed

[System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")]
public sealed class DependencyProperty

[<System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")>]
type DependencyProperty = class

Public NotInheritable Class DependencyProperty

Héritage

Object

DependencyProperty

Attributs

TypeConverterAttribute

Remarques

Un DependencyProperty prend en charge les fonctionnalités suivantes dans Windows Presentation Foundation (WPF) :

• La propriété peut être définie dans un style. Pour plus d’informations, consultez style et création de modèles.

• La propriété peut être définie via la liaison de données. Pour plus d’informations sur les propriétés de dépendance de liaison de données, consultez Guide pratique pour lier les propriétés de deux contrôles.

• La propriété peut être définie avec une référence de ressource dynamique. Pour plus d’informations, consultez ressources XAML.

• La propriété peut hériter automatiquement de sa valeur d’un élément parent dans l’arborescence d’éléments. Pour plus d’informations, consultez d’héritage de valeur de propriété.

• La propriété peut être animée. Pour plus d’informations, consultez Vue d’ensemble de l’animation.

• La propriété peut signaler lorsque la valeur précédente de la propriété a été modifiée et que la valeur de la propriété peut être cochée. Pour plus d’informations, consultez rappels de propriétés de dépendance etvalidation .

• La propriété signale des informations à WPF, par exemple si la modification d’une valeur de propriété doit exiger que le système de disposition récompose les visuels d’un élément.

• La propriété reçoit la prise en charge dans le Concepteur WPF pour Visual Studio. Par exemple, la propriété peut être modifiée dans la fenêtre Propriétés.

Pour en savoir plus sur les propriétés de dépendance, consultez Vue d’ensemble des propriétés de dépendance. Si vous souhaitez que les propriétés de vos types personnalisés prennent en charge les fonctionnalités de la liste précédente, vous devez créer une propriété de dépendance. Pour savoir comment créer des propriétés de dépendance personnalisées, consultez propriétés de dépendance personnalisées.

Une propriété jointe est une propriété qui permet à n’importe quel objet de signaler des informations au type qui définit la propriété jointe. Dans WPF, tout type qui hérite de DependencyObject peut utiliser une propriété jointe, que le type hérite du type qui définit la propriété. Une propriété jointe est une fonctionnalité du langage XAML. Pour définir une propriété jointe en XAML, utilisez leownerType . syntaxepropertyName. Un exemple de propriété jointe est la propriété DockPanel.Dock. Si vous souhaitez créer une propriété qui peut être utilisée sur tous les types DependencyObject, vous devez créer une propriété jointe. Pour en savoir plus sur les propriétés jointes, notamment comment les créer, consultez Vue d’ensemble des propriétés jointes.

Utilisation des attributs XAML

<object property="dependencyPropertyName"/>  

-ou-

<object property="ownerType.dependencyPropertyName"/>  

-ou-

<object property="attachedPropertyOwnerType.attachedPropertyName"/>  

Valeurs XAML

dependencyPropertyName
Chaîne qui spécifie la DependencyProperty.Name de la propriété de dépendance souhaitée. Cela peut être précédé d’un préfixe d’espace de noms XML si la propriété n’est pas dans l’espace de noms XML par défaut (pour plus d’informations, consultez espaces de noms XAML et mappage d’espaces de noms pour WPF XAML.)

ownerType.dependencyPropertyName
Chaîne qui spécifie un type de propriétaire d’une propriété de dépendance, un point (.), puis le DependencyProperty.Name. ownerType peut également être précédé d’un préfixe d’espace de noms XML. Cette utilisation est particulière aux styles et modèles à liaison tardive, où le propriétaire de la propriété de dépendance doit être spécifié pour le contexte d’analyse, car le TargetType n’est pas encore connu. Pour plus d’informations, consultez style et création de modèles.

attachedPropertyOwnerType .attachedPropertyName
Chaîne qui spécifie le propriétaire d’une propriété jointe, un point (.), puis le nom de la propriété jointe. attachedPropertyOwnerType peut également être précédé d’un préfixe d’espace de noms XML.

Champs

UnsetValue

Spécifie une valeur statique utilisée par le système de propriétés WPF plutôt que null pour indiquer que la propriété existe, mais n’a pas sa valeur définie par le système de propriétés.

Propriétés

DefaultMetadata	Obtient les métadonnées par défaut de la propriété de dépendance.
GlobalIndex	Obtient une valeur générée en interne qui identifie de manière unique la propriété de dépendance.
Name	Obtient le nom de la propriété de dépendance.
OwnerType	Obtient le type de l’objet qui a inscrit la propriété de dépendance avec le système de propriétés ou ajouté lui-même en tant que propriétaire de la propriété.
PropertyType	Obtient le type utilisé par la propriété de dépendance pour sa valeur.
ReadOnly	Obtient une valeur qui indique si la propriété de dépendance identifiée par cette instance DependencyProperty est une propriété de dépendance en lecture seule.
ValidateValueCallback	Obtient le rappel de validation de valeur pour la propriété de dépendance.

Méthodes

AddOwner(Type)	Ajoute un autre type en tant que propriétaire d’une propriété de dépendance qui a déjà été inscrite.
AddOwner(Type, PropertyMetadata)	Ajoute un autre type en tant que propriétaire d’une propriété de dépendance qui a déjà été inscrite, fournissant des métadonnées de propriété de dépendance pour la propriété de dépendance telle qu’elle existe sur le type de propriétaire fourni.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Retourne un code de hachage pour cette DependencyProperty.
GetMetadata(DependencyObject)	Retourne les métadonnées de cette propriété de dépendance telle qu’elle existe sur l’instance d’objet spécifiée.
GetMetadata(DependencyObjectType)	Retourne les métadonnées de cette propriété de dépendance telle qu’elle existe sur un type spécifié.
GetMetadata(Type)	Retourne les métadonnées de cette propriété de dépendance telle qu’elle existe sur un type existant spécifié.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
IsValidType(Object)	Détermine si une valeur spécifiée est acceptable pour le type de cette propriété de dépendance, comme vérifié par rapport au type de propriété fourni dans l’inscription de propriété de dépendance d’origine.
IsValidValue(Object)	Détermine si la valeur fournie est acceptée pour le type de propriété par le biais de la vérification de type de base, et éventuellement si elle se trouve dans la plage autorisée de valeurs pour ce type.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OverrideMetadata(Type, PropertyMetadata)	Spécifie d’autres métadonnées pour cette propriété de dépendance lorsqu’elle est présente sur des instances d’un type spécifié, en remplaçant les métadonnées qui existaient pour la propriété de dépendance, car elles étaient héritées des types de base.
OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey)	Fournit d’autres métadonnées pour une propriété de dépendance en lecture seule lorsqu’elle est présente sur des instances d’un type spécifié, en remplaçant les métadonnées fournies dans l’inscription initiale des propriétés de dépendance. Vous devez passer le DependencyPropertyKey pour la propriété de dépendance en lecture seule afin d’éviter de déclencher une exception.
Register(String, Type, Type)	Inscrit une propriété de dépendance avec le nom de propriété, le type de propriété et le type de propriétaire spécifiés.
Register(String, Type, Type, PropertyMetadata)	Inscrit une propriété de dépendance avec le nom de propriété, le type de propriété, le type de propriétaire et les métadonnées de propriété spécifiés.
Register(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Inscrit une propriété de dépendance avec le nom de propriété, le type de propriété, le type de propriétaire, les métadonnées de propriété et un rappel de validation de valeur pour la propriété.
RegisterAttached(String, Type, Type)	Inscrit une propriété jointe avec le nom de propriété, le type de propriété et le type de propriétaire spécifiés.
RegisterAttached(String, Type, Type, PropertyMetadata)	Inscrit une propriété jointe avec le nom de propriété, le type de propriété, le type de propriétaire et les métadonnées de propriété spécifiés.
RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Inscrit une propriété jointe avec le type de propriété, le type de propriétaire, les métadonnées de propriété et le rappel de validation de valeur spécifiés pour la propriété.
RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)	Inscrit une propriété jointe en lecture seule, avec le type de propriété, le type de propriétaire et les métadonnées de propriété spécifiés.
RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Inscrit une propriété jointe en lecture seule, avec le type de propriété, le type de propriétaire, les métadonnées de propriété et un rappel de validation.
RegisterReadOnly(String, Type, Type, PropertyMetadata)	Inscrit une propriété de dépendance en lecture seule, avec le type de propriété, le type de propriétaire et les métadonnées de propriété spécifiés.
RegisterReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Inscrit une propriété de dépendance en lecture seule, avec le type de propriété, le type de propriétaire, les métadonnées de propriété et un rappel de validation.
ToString()	Retourne la représentation sous forme de chaîne de la propriété de dépendance.

Voir aussi

• DependencyObject
• DependencyPropertyHelper