DependencyProperty Classe

Définition

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.Represents a property that can be set through methods such as, styling, data binding, animation, and inheritance.

public ref class DependencyProperty sealed
[System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")]
[System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")]
public sealed class DependencyProperty
type DependencyProperty = class
Public NotInheritable Class DependencyProperty
Héritage
DependencyProperty
Attributs

Remarques

Un DependencyProperty prend en charge les fonctionnalités suivantes dans Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF):A DependencyProperty supports the following capabilities in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF):

  • La propriété peut être définie dans un style.The property can be set in a style. Pour plus d’informations, consultez Application d’un style et création de modèles.For more information, see Styling and Templating.

  • La propriété peut être définie via la liaison de données.The property can be set through data binding. Pour plus d’informations sur les propriétés de dépendance de liaison de données, consultez procédure : Liez les propriétés de deux contrôles.For more information about data binding dependency properties, see How to: Bind the Properties of Two Controls.

  • La propriété peut être définie avec une référence de ressource dynamique.The property can be set with a dynamic resource reference. Pour plus d’informations, consultez Ressources XAML.For more information, see XAML Resources.

  • La propriété peut hériter sa valeur automatiquement d’un élément parent dans l’arborescence d’éléments.The property can inherit its value automatically from a parent element in the element tree. Pour plus d’informations, consultez Héritage de valeur de propriété.For more information, see Property Value Inheritance.

  • La propriété peut être animée.The property can be animated. Pour plus d’informations, consultez Vue d’ensemble de l’animation.For more information, see Animation Overview.

  • 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 forcée.The property can report when the previous value of the property has been changed and the property value can be coerced. Pour plus d’informations, consultez Validation et rappels de propriétés de dépendance.For more information, see Dependency Property Callbacks and Validation.

  • La propriété signale des informations à WPFWPF, par exemple si la modification d’une valeur de propriété doit obliger le système de disposition à recomposer les éléments visuels d’un élément.The property reports information to WPFWPF, such as whether changing a property value should require the layout system to recompose the visuals for an element.

  • La propriété reçoit la prise en charge dans le Concepteur WPF pour Visual StudioWPF Designer for Visual Studio.The property receives support in the Concepteur WPF pour Visual StudioWPF Designer for Visual Studio. Par exemple, la propriété peut être modifiée dans la fenêtre Propriétés .For example, the property can be edited in the Properties window.

Pour en savoir plus sur les propriétés de dépendance, consultez vue d’ensemble des propriétés de dépendance.To learn more about dependency properties, see Dependency Properties Overview. 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.If you want properties on your custom types to support the capabilities in the preceding list, you should create a dependency property. Pour savoir comment créer des propriétés de dépendance personnalisées, consultez Propriétés de dépendance personnalisées.To learn how to create custom dependency properties, see Custom Dependency Properties.

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.An attached property is a property that enables any object to report information to the type that defines the attached property. Dans WPFWPF, 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é ou non.In WPFWPF, any type that inherits from DependencyObject can use an attached property regardless of whether the type inherits from the type that defines the property. Une propriété jointe est une fonctionnalité du langage de XAMLXAML.An attached property is a feature of the XAMLXAML language. Pour définir une propriété jointe dans XAMLXAML, utilisez l’expression ownerType. syntaxe NomPropriété .To set an attached property in XAMLXAML, use the ownerType.propertyName syntax. La propriété DockPanel.Dock est un exemple de propriété jointe.An example of an attached property is the DockPanel.Dock property. Si vous souhaitez créer une propriété qui peut être utilisée sur tous les types de DependencyObject, vous devez créer une propriété jointe.If you want to create a property that can be used on all DependencyObject types, then you should create an attached property. Pour en savoir plus sur les propriétés jointes, notamment sur la façon de les créer, consultez vue d’ensemble des propriétés jointes.To learn more about attached properties, including how to create them, see Attached Properties Overview.

Utilisation d'attributs XAMLXAML Attribute Usage

<object property="dependencyPropertyName"/>  

- ou --or-

<object property="ownerType.dependencyPropertyName"/>  

- ou --or-

<object property="attachedPropertyOwnerType.attachedPropertyName"/>  

Valeurs XAMLXAML Values

dependencyPropertyName
Chaîne qui spécifie le DependencyProperty.Name de la propriété de dépendance souhaitée.A string that specifies the DependencyProperty.Name of the desired dependency property. Il 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’espace de noms pour XAML WPF.)This can be preceded by an XML namespace prefix if the property is not in the default XML namespace (for details, see XAML Namespaces and Namespace Mapping for WPF XAML.)

ownerType.dependencyPropertyNameownerType.dependencyPropertyName
Chaîne qui spécifie un type de propriétaire d’une propriété de dépendance, un point (.), puis le DependencyProperty.Name.A string that specifies an owner type of a dependency property, a dot (.), then the DependencyProperty.Name. ownerType peuvent également être précédées d’un préfixe d’espace de noms XML.ownerType can also be preceded by an XML namespace prefix. Cette utilisation est spécifique aux styles à liaison tardive et aux modèles, 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.This usage is particular to late-bound styles and templates, where the owner of the dependency property must be specified for parsing context because the TargetType is not yet known. Pour plus d’informations, consultez Application d’un style et création de modèles.For more information, see Styling and Templating.

attachedPropertyOwnerType .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.A string that specifies the owner of an attached property, a dot (.), then the attached property name. attachedPropertyOwnerType peuvent également être précédées d’un préfixe d’espace de noms XML.attachedPropertyOwnerType can also be preceded by an XML namespace prefix.

Champs

UnsetValue

Spécifie une valeur statique qui est utilisée par le système de propriétés WPFWPF plutôt que null pour indiquer que la propriété existe, mais sa valeur n'est pas définie par le système de propriétés.Specifies a static value that is used by the WPFWPF property system rather than null to indicate that the property exists, but does not have its value set by the property system.

Propriétés

DefaultMetadata

Obtient les métadonnées par défaut de la propriété de dépendance.Gets the default metadata of the dependency property.

GlobalIndex

Obtient une valeur générée en interne qui identifie uniquement la propriété de dépendance.Gets an internally generated value that uniquely identifies the dependency property.

Name

Obtient le nom de la propriété de dépendance.Gets the name of the dependency property.

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é.Gets the type of the object that registered the dependency property with the property system, or added itself as owner of the property.

PropertyType

Obtient le type que la propriété de dépendance utilise pour sa valeur.Gets the type that the dependency property uses for its value.

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.Gets a value that indicates whether the dependency property identified by this DependencyProperty instance is a read-only dependency property.

ValidateValueCallback

Obtient le rappel de validation de valeur pour la propriété de dépendance.Gets the value validation callback for the dependency property.

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.Adds another type as an owner of a dependency property that has already been registered.

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.Adds another type as an owner of a dependency property that has already been registered, providing dependency property metadata for the dependency property as it will exist on the provided owner type.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Retourne un code de hachage pour ce DependencyProperty.Returns a hash code for this 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.Returns the metadata for this dependency property as it exists on the specified object instance.

GetMetadata(DependencyObjectType)

Retourne les métadonnées pour cette propriété de dépendance telle qu’elles existent sur un type spécifié.Returns the metadata for this dependency property as it exists on a specified type.

GetMetadata(Type)

Retourne les métadonnées pour cette propriété de dépendance telle qu’elles existent sur un type existant spécifié.Returns the metadata for this dependency property as it exists on a specified existing type.

GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(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.Determines whether a specified value is acceptable for this dependency property's type, as checked against the property type provided in the original dependency property registration.

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.Determines whether the provided value is accepted for the type of property through basic type checking, and also potentially if it is within the allowed range of values for that type.

MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(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.Specifies alternate metadata for this dependency property when it is present on instances of a specified type, overriding the metadata that existed for the dependency property as it was inherited from base types.

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.Supplies alternate metadata for a read-only dependency property when it is present on instances of a specified type, overriding the metadata that was provided in the initial dependency property registration. Vous devez passer DependencyPropertyKey pour la propriété de dépendance en lecture seule pour éviter de lever une exception.You must pass the DependencyPropertyKey for the read-only dependency property to avoid raising an 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.Registers a dependency property with the specified property name, property type, and owner type.

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.Registers a dependency property with the specified property name, property type, owner type, and property metadata.

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é.Registers a dependency property with the specified property name, property type, owner type, property metadata, and a value validation callback for the property.

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.Registers an attached property with the specified property name, property type, and owner type.

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.Registers an attached property with the specified property name, property type, owner type, and property metadata.

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é.Registers an attached property with the specified property type, owner type, property metadata, and value validation callback for the property.

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.Registers a read-only attached property, with the specified property type, owner type, and property metadata.

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.Registers a read-only attached property, with the specified property type, owner type, property metadata, and a validation callback.

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.Registers a read-only dependency property, with the specified property type, owner type, and property metadata.

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.Registers a read-only dependency property, with the specified property type, owner type, property metadata, and a validation callback.

ToString()

Retourne la représentation sous forme de chaîne de la propriété de dépendance.Returns the string representation of the dependency property.

S’applique à

Voir aussi