DependencyObject.SetValue Method

Définit la valeur locale d'une propriété de dépendance sur un DependencyObject.

Syntaxe


public void SetValue(
  DependencyProperty dp, 
  object value
)

Paramètres

dp

Type: DependencyProperty

Identificateur de la propriété de dépendance à définir.

value

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

La nouvelle valeur de proximité.

Remarques

Si le type value fourni ne correspond pas au type déclaré pour la propriété de dépendance lors de l'enregistrement d'origine, une exception est levée.

Certaines propriétés Windows Runtime utilisées par XAML sont des propriétés de dépendance. Un identificateur DependencyProperty doit exister et doit être disponible en tant que propriété publique d'un objet propriétaire, en général l'objet qui a inscrit la propriété.

Pour le code utilisateur de l'application, l'appel de SetValue n'est généralement pas nécessaire. Généralement, une propriété de dépendance Windows Runtime ou une propriété de dépendance personnalisée possède une propriété classique qui l'encapsule et vous pouvez simplement définir la valeur de propriété via une utilisation classique en pointillés. Les cas où vous pouvez toujours utiliser SetValue sont :

  • Vous définissez une propriété de dépendance personnalisée. Vous appellerez SetValue dans le cadre de la définition de votre propre accesseur set de propriété pour une utilisation classique de propriété. Pour plus d'informations, consultez Propriétés de dépendance personnalisées.
  • Vous définissez un rappel ou vous vous trouvez dans une autre portée où vous passez déjà un identificateur DependencyProperty, et il est possible que plusieurs propriétés de dépendance existent avec lesquelles vous pouvez interagir dans cette portée. Dans ces cas, il est probablement plus simple d'appeler SetValue, en passant l'identificateur.

Exemples

Cet exemple montre une déclaration de propriété de dépendance simple. Un appel à SetValue constitue l'intégralité de l'implémentation de l'accesseur set 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
Propriétés de dépendance personnalisées
Vue d'ensemble des propriétés de dépendance
Exemples de contrôles utilisateur et personnalisés en XML

 

 

Afficher:
© 2014 Microsoft