DependencyObject.SetValue DependencyObject.SetValue DependencyObject.SetValue DependencyObject.SetValue Method

Définition

Définit la valeur de proximité d’une propriété de dépendance.Sets the local value of a dependency property.

Surcharges

SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) 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.Sets the local value of a dependency property, specified by its dependency property identifier.

SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) 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.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) 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.Sets the local value of a dependency property, specified by its dependency property identifier.

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 DependencyProperty DependencyProperty DependencyProperty

Identificateur de la propriété de dépendance à définir.The identifier of the dependency property to set.

value
Object Object Object Object

La nouvelle valeur de proximité.The new local value.

Exceptions

Tentative de modification d'une propriété de dépendance en lecture seule, ou d'une propriété sur un DependencyObject sealed.Attempted to modify a read-only dependency property, or a property on a sealed DependencyObject.

value n'était pas le type correct enregistré pour la propriété dp.value was not the correct type as registered for the dp property.

Remarques

Si le type fourni ne correspond pas au type déclaré pour la propriété de dépendance car il a été inscrit à l’origine, une exception est levée.If the provided type does not match the type that is declared for the dependency property as it was originally registered, an exception is thrown. Le value paramètre doit toujours être fourni comme le type approprié.The value parameter should always be provided as the appropriate type.

Les conditions d’exception sont influencées potentiellement par le ValidateValueCallback rappel existe sur l’identificateur de propriété de dépendance de la propriété de dépendance qui est définie.The exception conditions are potentially influenced by the ValidateValueCallback callback that exists on the dependency property identifier of the dependency property being set. Sinon, la valeur fournie est possible en échec des conditions générales la vérification de type (par exemple, en passant une chaîne lorsque le type natif est Double).Otherwise, the value provided might be failing general type-checking conditions (for example, passing a string when the native type is Double).

SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) 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.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

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 DependencyPropertyKey DependencyPropertyKey DependencyPropertyKey

L'identificateur DependencyPropertyKey de la propriété à définir.The DependencyPropertyKey identifier of the property to set.

value
Object Object Object Object

La nouvelle valeur de proximité.The new local value.

Exemples

L’exemple suivant définit une propriété de dépendance en lecture seule, avec un public static readonly DependencyProperty qui fournit l’exposition d’en lecture seule nécessaire aux consommateurs de propriété et l’accesseur get pour la CLRCLR wrapper.The following example defines a read-only dependency property, along with a public static readonly DependencyProperty that provides necessary read-only exposure to property consumers, and the get accessor for the CLRCLR wrapper.

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 qui sont définies par vos classes personnalisées.This signature is generally used when you set values for read-only dependency properties that are defined by your custom classes. En règle générale, SetValue est appelée uniquement à partir du type qui 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.Generally, SetValue is called only from the type that registered that dependency property, which implements the internal logic that provides the determined value for the dependency property. Pour plus d’informations, consultez Propriétés de dépendance en lecture seule.For more information, see Read-Only Dependency Properties.

Si le type fourni ne correspond pas au type déclaré pour la propriété de dépendance car il a été inscrit à l’origine, une exception est levée.If the provided type does not match the type that is declared for the dependency property as it was originally registered, an exception is thrown. Le value paramètre doit toujours être fourni comme le type approprié.The value parameter should always be provided as the appropriate type. Les conditions d’exception sont influencées potentiellement par le ValidateValueCallback rappel existe sur l’identificateur de propriété de dépendance de la propriété de dépendance qui est définie.The exception conditions are potentially influenced by the ValidateValueCallback callback that exists on the dependency property identifier of the dependency property being set.

S’applique à