DependencyObject.SetValue Méthode

Définition

Espace de noms:

System.Windows

Assembly:

WindowsBase.dll

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

InvalidOperationException

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

ArgumentException

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).

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.