DependencyObject.ReadLocalValue(DependencyProperty) Méthode

Définition

Retourne la valeur locale d’une propriété de dépendance, si elle existe.Returns the local value of a dependency property, if it exists.

public:
 System::Object ^ ReadLocalValue(System::Windows::DependencyProperty ^ dp);
public object ReadLocalValue (System.Windows.DependencyProperty dp);
member this.ReadLocalValue : System.Windows.DependencyProperty -> obj
Public Function ReadLocalValue (dp As DependencyProperty) As Object

Paramètres

dp
DependencyProperty

Identificateur DependencyProperty de la propriété pour laquelle récupérer la valeur.The DependencyProperty identifier of the property to retrieve the value for.

Retours

Retourne la valeur locale ou la valeur de la sentinelle UnsetValue si aucune valeur locale n’est définie.Returns the local value, or returns the sentinel value UnsetValue if no local value is set.

Remarques

Vous devez utiliser GetValue pour les opérations « obtenir » les plus courantes pour une propriété de dépendance.You should use GetValue for most typical "get" operations for a dependency property. ReadLocalValue ne retourne pas la valeur effective pour une variété de circonstances où la valeur n’a pas été définie localement.ReadLocalValue does not return the effective value for a variety of circumstances where the value was not locally set.

Les valeurs définies par les styles, les thèmes, les modèles, la valeur par défaut des métadonnées ou l’héritage de la valeur de propriété ne sont pas considérées comme des valeurs locales.Values that are set by styles, themes, templates, the default value from metadata, or property value inheritance are not considered to be local values. Toutefois, les liaisons et autres expressions sont considérées comme des valeurs locales, une fois qu’elles ont été évaluées.However, bindings and other expressions are considered to be local values, after they have been evaluated.

Quand aucune valeur locale n’est définie, cette méthode retourne UnsetValue.When no local value is set, this method returns UnsetValue.

Si la valeur retournée est différente de UnsetValue, vous pouvez interroger les métadonnées de la propriété de dépendance demandée pour déterminer s’il existe un type plus spécifique dans lequel la valeur de retour peut être convertie.If the returned value is other than UnsetValue, you can query the metadata of the requested dependency property to determine whether there is a more specific type that the return value can be converted to.

S’applique à

Voir aussi