DependencyObject.SetValue Méthode

Définition

Espace de noms:

System.Windows

Assembly:

WindowsBase.dll

Définit la valeur de proximité 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

Vous avez tenté de modifier une propriété de dépendance en lecture seule ou une propriété sur un DependencyObject sealed.

ArgumentException

value ne correspond pas au type 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 comme il a été inscrit à l’origine, une exception est levée. Le value paramètre doit toujours être fourni en tant que type approprié.

Les conditions d’exception sont potentiellement influencées par le rappel qui existe sur l’identificateur ValidateValueCallback 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’une public static readonly DependencyProperty 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 elle 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 Propriétés de dépendance en lecture seule.

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