Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

DependencyProperty classe

 

Date de publication : novembre 2016

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.

Espace de noms:   System.Windows
Assembly:  WindowsBase (dans WindowsBase.dll)

System.Object
  System.Windows.DependencyProperty

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

NomDescription
System_CAPS_pubpropertyDefaultMetadata

Obtient les métadonnées par défaut de la propriété de dépendance.

System_CAPS_pubpropertyGlobalIndex

Obtient une valeur générée en interne qui identifie la propriété de dépendance.

System_CAPS_pubpropertyName

Obtient le nom de la propriété de dépendance.

System_CAPS_pubpropertyOwnerType

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é.

System_CAPS_pubpropertyPropertyType

Obtient le type de la propriété de dépendance utilise pour sa valeur.

System_CAPS_pubpropertyReadOnly

Obtient une valeur qui indique si la propriété de dépendance identifié par cet DependencyProperty instance est une propriété de dépendance en lecture seule.

System_CAPS_pubpropertyValidateValueCallback

Obtient le rappel de validation de valeur pour la propriété de dépendance.

NomDescription
System_CAPS_pubmethodAddOwner(Type)

Ajoute un autre type en tant que propriétaire d’une propriété de dépendance qui a déjà été inscrite.

System_CAPS_pubmethodAddOwner(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.

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodGetHashCode()

Retourne un code de hachage pour ce DependencyProperty.(Remplace Object.GetHashCode().)

System_CAPS_pubmethodGetMetadata(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.

System_CAPS_pubmethodGetMetadata(DependencyObjectType)

Retourne les métadonnées pour cette propriété de dépendance telle qu’elles existent sur un type spécifié.

System_CAPS_pubmethodGetMetadata(Type)

Retourne les métadonnées pour cette propriété de dépendance telle qu’elles existent sur un type existant spécifié.

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodIsValidType(Object)

Détermine si la 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.

System_CAPS_pubmethodIsValidValue(Object)

Détermine si la valeur fournie est acceptée pour le type de propriété par la vérification de type de base et également si elle se trouve dans la plage autorisée de valeurs pour ce type.

System_CAPS_pubmethodOverrideMetadata(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.

System_CAPS_pubmethodOverrideMetadata(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.

System_CAPS_pubmethodSystem_CAPS_staticRegister(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.

System_CAPS_pubmethodSystem_CAPS_staticRegister(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.

System_CAPS_pubmethodSystem_CAPS_staticRegister(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é.

System_CAPS_pubmethodSystem_CAPS_staticRegisterAttached(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.

System_CAPS_pubmethodSystem_CAPS_staticRegisterAttached(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.

System_CAPS_pubmethodSystem_CAPS_staticRegisterAttached(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é.

System_CAPS_pubmethodSystem_CAPS_staticRegisterAttachedReadOnly(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.

System_CAPS_pubmethodSystem_CAPS_staticRegisterAttachedReadOnly(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.

System_CAPS_pubmethodSystem_CAPS_staticRegisterReadOnly(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.

System_CAPS_pubmethodSystem_CAPS_staticRegisterReadOnly(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.

System_CAPS_pubmethodToString()

Retourne la représentation sous forme de chaîne de la propriété de dépendance.(Remplace Object.ToString().)

NomDescription
System_CAPS_pubfieldSystem_CAPS_staticUnsetValue

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

A T:System.Windows.DependencyProperty supports the following capabilities in TLA#tla_winclient:

  • The property can be set in a style. For more information, see Styling and Templating.

  • The property can be set through data binding. For more information about data binding dependency properties, see How to: Bind the Properties of Two Controls.

  • The property can be set with a dynamic resource reference. For more information, see XAML Resources.

  • The property can inherit its value automatically from a parent element in the element tree. For more information, see Property Value Inheritance.

  • The property can be animated. For more information, see Animation Overview.

  • The property can report when the previous value of the property has been changed and the property value can be coerced. For more information, see Dependency Property Callbacks and Validation.

  • The property reports information to TLA2#tla_winclient, such as whether changing a property value should require the layout system to recompose the visuals for an element.

  • The property receives support in the wpfdesigner_current_long. For example, the property can be edited in the Properties window.

To learn more about dependency properties, see Dependency Properties Overview. If you want properties on your custom types to support the capabilities in the preceding list, you should create a dependency property. To learn how to create custom dependency properties, see Custom Dependency Properties.

An attached property is a property that enables any object to report information to the type that defines the attached property. In TLA2#tla_winclient, any type that inherits from T:System.Windows.DependencyObject can use an attached property regardless of whether the type inherits from the type that defines the property. An attached property is a feature of the TLA2#tla_xaml language.  To set an attached property in TLA2#tla_xaml, use the ownerType.propertyName syntax. An example of an attached property is the P:System.Windows.Controls.DockPanel.Dock property. If you want to create a property that can be used on all T:System.Windows.DependencyObject types, then you should create an attached property. To learn more about attached properties, including how to create them, see Attached Properties Overview.

<object property="dependencyPropertyName"/>
- or -
<object property="ownerType.dependencyPropertyName"/>
- or -
<object property="attachedPropertyOwnerType.attachedPropertyName"/>

dependencyPropertyName

A string that specifies the P:System.Windows.DependencyProperty.Name of the desired dependency property. 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.dependencyPropertyName

A string that specifies an owner type of a dependency property, a dot (.), then the P:System.Windows.DependencyProperty.Name. ownerType can also be preceded by an XML namespace prefix. 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. For more information, see Styling and Templating.

attachedPropertyOwnerType.attachedPropertyName

A string that specifies the owner of an attached property, a dot (.), then the attached property name. attachedPropertyOwnerType can also be preceded by an XML namespace prefix.

.NET Framework
Disponible depuis 3.0
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: