DependencyObject.SetValue Méthode

Définition

Définit la valeur locale d’une propriété de dépendance.

Surcharges

SetValue(DependencyProperty, Object)

Définit la valeur locale d’une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance.

SetValue(DependencyPropertyKey, Object)

Définit la valeur locale d’une propriété de dépendance en lecture seule, spécifiée par l’identificateur DependencyPropertyKey de la propriété de dépendance.

SetValue(DependencyProperty, Object)

Définit la valeur locale d’une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance.

public:
 void SetValue(System::Windows::DependencyProperty ^ dp, System::Object ^ value);
public void SetValue (System.Windows.DependencyProperty dp, object value);
member this.SetValue : System.Windows.DependencyProperty * obj -> unit
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

Nouvelle valeur locale.

Exceptions

Tentative de modification d’une propriété de dépendance en lecture seule ou d’une propriété sur une DependencyObjectscellée .

value n’était pas le type correct inscrit pour la propriété dp.

Remarques

Si le type fourni ne correspond pas au type déclaré pour la propriété de dépendance tel qu’il a été inscrit à l’origine, une exception est levée. Le paramètre value doit toujours être fourni en tant que type approprié.

Les conditions d’exception sont potentiellement influencées par le rappel ValidateValueCallback qui existe sur l’identificateur de propriété de dépendance de la propriété de dépendance définie. Sinon, la valeur fournie peut échouer à des conditions générales de vérification de type (par exemple, en passant une chaîne lorsque le type natif est Double).

S’applique à

SetValue(DependencyPropertyKey, Object)

Définit la valeur locale d’une propriété de dépendance en lecture seule, spécifiée par l’identificateur DependencyPropertyKey de la propriété de dépendance.

public:
 void SetValue(System::Windows::DependencyPropertyKey ^ key, System::Object ^ value);
public void SetValue (System.Windows.DependencyPropertyKey key, object value);
member this.SetValue : System.Windows.DependencyPropertyKey * obj -> unit
Public Sub SetValue (key As DependencyPropertyKey, value As Object)

Paramètres

key
DependencyPropertyKey

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

value
Object

Nouvelle valeur locale.

Exemples

L’exemple suivant définit une propriété de dépendance en lecture seule, ainsi qu’un public static readonlyDependencyProperty qui fournit une exposition en lecture seule nécessaire aux consommateurs de propriétés et l’accesseur get pour le wrapper CLR.

internal static readonly DependencyPropertyKey AquariumSizeKey = DependencyProperty.RegisterReadOnly(
  "AquariumSize",
  typeof(double),
  typeof(Aquarium),
  new PropertyMetadata(double.NaN)
);
public static readonly DependencyProperty AquariumSizeProperty =
  AquariumSizeKey.DependencyProperty;
public double AquariumSize
{
  get { return (double)GetValue(AquariumSizeProperty); }
}
Friend Shared ReadOnly AquariumSizeKey As DependencyPropertyKey = DependencyProperty.RegisterReadOnly("AquariumSize", GetType(Double), GetType(Aquarium), New PropertyMetadata(Double.NaN))
Public Shared ReadOnly AquariumSizeProperty As DependencyProperty = AquariumSizeKey.DependencyProperty
Public ReadOnly Property AquariumSize() As Double
    Get
        Return CDbl(GetValue(AquariumSizeProperty))
    End Get
End Property

Remarques

Cette signature est généralement utilisée lorsque vous définissez des valeurs pour les propriétés de dépendance en lecture seule définies par vos classes personnalisées. En règle générale, SetValue est appelée uniquement à partir du type qui a inscrit cette propriété de dépendance, qui implémente la logique interne qui fournit la valeur déterminée pour la propriété de dépendance. Pour plus d’informations, consultez Read-Only propriétés de dépendance.

Si le type fourni ne correspond pas au type déclaré pour la propriété de dépendance tel qu’il a été inscrit à l’origine, une exception est levée. Le paramètre value doit toujours être fourni en tant que type approprié. Les conditions d’exception sont potentiellement influencées par le rappel ValidateValueCallback qui existe sur l’identificateur de propriété de dépendance de la propriété de dépendance définie.

S’applique à