DependencyObject.SetValue Method

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

Syntaxe

Public Sub SetValue(
  dp As DependencyProperty,  
  value As Object 
)

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
    Inherits Control

    Public Shared ReadOnly SpeciesProperty As DependencyProperty = _
    DependencyProperty.Register(
    "Species", _
    GetType(String), _
    GetType(Fish), _
    Nothing)
    Public Property Species As String
        Get
            Species = CType(GetValue(SpeciesProperty), String)
        End Get
        Set(value As String)
            SetValue(SpeciesProperty, value)
        End Set
    End Property
End Class

Configuration requise

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