DependencyObject.SetValue Méthode

Définition

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

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

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 telle qu’elle a été inscrite à l’origine, une exception est levée. Le value paramètre doit toujours être fourni comme type approprié.

Les conditions d’exception sont potentiellement influencées par le ValidateValueCallback rappel qui existe sur l’identificateur de propriété de dépendance de la propriété de dépendance qui est définie. Dans le cas contraire, 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 public static readonly DependencyProperty qu’un qui fournit l’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 général, SetValue est appelé 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 telle qu’elle a été inscrite à l’origine, une exception est levée. Le value paramètre doit toujours être fourni comme type approprié. Les conditions d’exception sont potentiellement influencées par le ValidateValueCallback rappel qui existe sur l’identificateur de propriété de dépendance de la propriété de dépendance qui est définie.

S’applique à