Partage via


DependencyObject.SetValue(DependencyProperty, Object) Méthode

Définition

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)

Paramètres

dp
DependencyProperty

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

value
Object

Platform::Object

IInspectable

Nouvelle valeur locale.

Remarques

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.

S’applique à

Voir aussi