DependencyObject.SetValue Metoda

Definice

Nastaví místní hodnotu vlastnosti závislosti.Sets the local value of a dependency property.

Přetížení

SetValue(DependencyProperty, Object)

Nastaví místní hodnotu vlastnosti závislosti určenou identifikátorem vlastnosti závislosti.Sets the local value of a dependency property, specified by its dependency property identifier.

SetValue(DependencyPropertyKey, Object)

Nastaví místní hodnotu vlastnosti závislosti jen pro čtení určenou DependencyPropertyKey identifikátorem vlastnosti závislosti.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

SetValue(DependencyProperty, Object)

Nastaví místní hodnotu vlastnosti závislosti určenou identifikátorem vlastnosti závislosti.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)

Parametry

dp
DependencyProperty

Identifikátor vlastnosti závislosti, která se má nastavitThe identifier of the dependency property to set.

value
Object

Nová místní hodnota.The new local value.

Výjimky

Došlo k pokusu o změnu vlastnosti závislosti jen pro čtení nebo vlastnosti zapečetěné DependencyObject .Attempted to modify a read-only dependency property, or a property on a sealed DependencyObject.

value nebyl správný typ registrovaný pro dp vlastnost.value was not the correct type as registered for the dp property.

Poznámky

Pokud poskytnutý typ neodpovídá typu deklarovanému pro vlastnost závislosti, který byl původně registrován, je vyvolána výjimka.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. valueParametr by měl být vždy poskytnutý jako příslušný typ.The value parameter should always be provided as the appropriate type.

Podmínky výjimky jsou potenciálně ovlivněny ValidateValueCallback zpětným voláním, které existuje u identifikátoru vlastnosti závislosti u nastavené vlastnosti závislosti.The exception conditions are potentially influenced by the ValidateValueCallback callback that exists on the dependency property identifier of the dependency property being set. V opačném případě může poskytnutá hodnota selhat při obecných podmínkách kontroly typu (například předání řetězce, pokud je nativní typ Dvojitá).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)

Nastaví místní hodnotu vlastnosti závislosti jen pro čtení určenou DependencyPropertyKey identifikátorem vlastnosti závislosti.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)

Parametry

key
DependencyPropertyKey

DependencyPropertyKeyIdentifikátor vlastnosti, kterou chcete nastavit.The DependencyPropertyKey identifier of the property to set.

value
Object

Nová místní hodnota.The new local value.

Příklady

Následující příklad definuje vlastnost závislosti jen pro čtení společně s a public static readonly DependencyProperty , která poskytuje nezbytnou expozici pro čtení pro uživatele a přístup k objektu get pro CLRCLR obálku.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

Poznámky

Tento podpis se obecně používá při nastavování hodnot vlastností závislosti jen pro čtení, které jsou definovány vašimi vlastními třídami.This signature is generally used when you set values for read-only dependency properties that are defined by your custom classes. Obecně SetValue je volána pouze z typu, který zaregistroval tuto vlastnost závislosti, která implementuje interní logiku, která poskytuje určenou hodnotu pro vlastnost závislosti.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. Další informace najdete v tématu vlastnosti závislosti jen pro čtení.For more information, see Read-Only Dependency Properties.

Pokud poskytnutý typ neodpovídá typu deklarovanému pro vlastnost závislosti, který byl původně registrován, je vyvolána výjimka.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. valueParametr by měl být vždy poskytnutý jako příslušný typ.The value parameter should always be provided as the appropriate type. Podmínky výjimky jsou potenciálně ovlivněny ValidateValueCallback zpětným voláním, které existuje u identifikátoru vlastnosti závislosti u nastavené vlastnosti závislosti.The exception conditions are potentially influenced by the ValidateValueCallback callback that exists on the dependency property identifier of the dependency property being set.

Platí pro