DependencyObject.SetValue(DependencyProperty, Object) Méthode
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit la valeur locale d’une propriété de dépendance sur un DependencyObject.
public:
virtual void SetValue(DependencyProperty ^ dp, Platform::Object ^ value) = SetValue;void SetValue(DependencyProperty const& dp, IInspectable const& value);public void SetValue(DependencyProperty dp, object value);function setValue(dp, value)Public Sub SetValue (dp As DependencyProperty, value As Object)Identificateur de la propriété de dépendance à définir.
- value
-
Object
Platform::Object
IInspectable
Nouvelle valeur locale.
Si le type de valeur fourni ne correspond pas au type déclaré pour la propriété de dépendance telle qu’elle a été inscrite à l’origine, une exception est levée.
Toutes les propriétés Windows Runtime utilisées par XAML ne sont pas des propriétés de dépendance. Un identificateur DependencyProperty doit exister et il doit être disponible en tant que propriété publique d’un objet propriétaire, généralement 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. En règle générale, une propriété de dépendance Windows Runtime ou une propriété de dépendance personnalisée a une propriété conventionnelle qui l’encapsule, et vous pouvez simplement définir la valeur de la propriété par le biais d’une utilisation conventionnelle en pointillés. Les cas où vous pouvez toujours utiliser SetValue sont les suivants :
- Vous définissez une propriété de dépendance personnalisée. Vous allez appeler SetValue dans le cadre de la définition de votre propre accesseur de jeu de propriétés pour une utilisation de propriété conventionnelle. Pour plus d’informations, voir Propriétés de dépendance personnalisées.
- Vous définissez un rappel ou êtes dans une autre étendue où vous êtes déjà passé un identificateur DependencyProperty , et il est possible qu’il existe plusieurs propriétés de dépendance avec lesquelles vous souhaitez interagir dans cette étendue. Dans ce cas, il est probablement plus simple d’appeler SetValue, en passant l’identificateur.
| Produit | Versions |
|---|---|
| WinRT | Build 10240, Build 10586, Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100 |