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, par exemple style, liaison de données, animation et héritage.

public ref class DependencyProperty sealed

[System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=3.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")]
public sealed class DependencyProperty

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

[<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

A 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 Application d’un style et création de modèles.

• La propriété peut être définie par le biais de 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 à partir d’un élément parent dans l’arborescence d’éléments. Pour plus d’informations, consultez 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 coéchée. Pour plus d’informations, consultez Validation et rappels de propriétés de dépendance.

• 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 du 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 à tout 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 le ownerType. syntaxe propertyName . Un exemple de propriété jointe est la DockPanel.Dock propriété. Si vous souhaitez créer une propriété qui peut être utilisée sur tous les DependencyObject types, 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 d'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 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 liés à la fin, où le propriétaire de la propriété de dépendance doit être spécifié pour le contexte d’analyse, car il TargetType n’est pas encore connu. Pour plus d’informations, consultez Application d’un 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 d’indiquer que la propriété existe, mais qui 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 uniquement 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 qui s’est ajouté comme propriétaire de la propriété.
PropertyType	Obtient le type que la propriété de dépendance utilise pour sa valeur.
ReadOnly	Obtient une valeur qui indique si la propriété de dépendance identifié 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 déjà inscrite, et fournit des métadonnées de propriété de dépendance à 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 ce DependencyProperty.
GetMetadata(DependencyObject)	Retourne les métadonnées pour cette propriété de dépendance telle qu’elles existent sur l’instance d’objet spécifiée.
GetMetadata(DependencyObjectType)	Retourne les métadonnées pour cette propriété de dépendance telle qu’elles existent sur un type spécifié.
GetMetadata(Type)	Retourne les métadonnées pour cette propriété de dépendance telle qu’elles existent sur un type existant spécifié.
GetType()	Obtient le 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é à travers la vérification de type de base, et également si elle se trouve dans la plage de valeurs autorisée pour ce type.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OverrideMetadata(Type, PropertyMetadata)	Spécifie les métadonnées de remplacement pour cette propriété de dépendance quand elle est présente sur des instances d’un type spécifié, substituant les métadonnées qui existaient pour la propriété de dépendance quand elle a été héritée de types de base.
OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey)	Fournit des métadonnées de remplacement pour une propriété de dépendance en lecture seule quand elle est présente sur des instances d’un type spécifié, substituant les métadonnées fournies dans l’inscription de la propriété de dépendance initiale. Vous devez passer DependencyPropertyKey pour la propriété de dépendance en lecture seule pour éviter de lever 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étaire et les métadonnées de propriété spécifiés, ainsi qu’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 et les métadonnées de propriété spécifiés, ainsi qu’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 et les métadonnées de propriété spécifiés, ainsi qu’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