DependencyObject.GetValue Method

Retourne la valeur effective actuelle d'une propriété de dépendance sur cette instance d'un DependencyObject.

Syntaxe


public object GetValue(
  DependencyProperty dp
)

Paramètres

dp

Type: DependencyProperty

L'identificateur DependencyProperty de la propriété pour lequel récupérer la valeur.

Valeur de retour

Type: System.Object [.NET] | Platform::Object [C++]

Retourne la valeur effective actuelle.

Remarques

GetValue obtient la valeur effective actuelle d'une propriété de dépendance. La valeur effective actuelle est déterminée en utilisant les règles de priorité de propriété de dépendance Vue d’ensemble des propriétés de dépendance.

GetValue est l'API nécessaire dans la plupart des cas si vous utilisez les API du système de propriétés pour obtenir les valeurs de propriété. Cependant, vous pouvez examiner les autres valeurs pour voir comment la priorité de propriété de dépendance agit pour une propriété donnée. Dans ce cas, vous pouvez utiliser l'une de ces API :

  • GetAnimationBaseValue pour obtenir des valeurs qui peuvent être actuellement animées, mais vous souhaitez connaître la valeur avant l'exécution de l'animation. Notez que les animations avec un comportement HoldEnd ne peuvent pas avoir la même valeur. Pour plus d'informations sur le concept HoldEnd, consultez Démarrage rapide : animation de votre interface utilisateur.
  • ReadLocalValue pour obtenir la valeur locale, pour laquelle aucun style, modèle ou animation n'est appliqué. Les liaisons comptent comme des valeurs locales, mais en fonction du moment d'appel de ReadLocalValue, le contexte de liaison d'action peut ne pas être disponible. Dans ce cas, vous n'obtiendrez pas la même valeur que s'il avait été appliqué au moment de l'exécution.

Pour plus d'informations sur la priorité de propriété de dépendance et d'autres API d'utilitaire de système de propriétés, consultez Vue d'ensemble des propriétés de dépendance.

Exemples

Cet exemple montre une déclaration de propriété de dépendance simple. Un appel à GetValue constitue l'intégralité de l'implémentation de l'accesseur get pour le wrapper de propriété de la nouvelle propriété de dépendance. Pour obtenir plus d'exemples, consultez Propriétés de dépendance personnalisées.


public class Fish : Control
{
    public static readonly DependencyProperty SpeciesProperty =
    DependencyProperty.Register(
    "Species",
    typeof(String),
    typeof(Fish), null
    );
    public string Species
    {
        get { return (string)GetValue(SpeciesProperty); }
        set { SetValue(SpeciesProperty, (string)value); }
    }
}


Configuration requise

Client minimal pris en charge

Windows 8

Serveur minimal pris en charge

Windows Server 2012

Espace de noms

Windows.UI.Xaml
Windows::UI::Xaml [C++]

Métadonnées

Windows.winmd

Voir aussi

DependencyObject
SetValue
Propriétés de dépendance personnalisées
Vue d'ensemble des propriétés de dépendance

 

 

Afficher:
© 2014 Microsoft