DependencyObject.SetValue Methode

Definition

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest.Sets the local value of a dependency property.

Überlädt

SetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die über ihren Bezeichner angegeben wird.Sets the local value of a dependency property, specified by its dependency property identifier.

SetValue(DependencyPropertyKey, Object)

Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey-Bezeichner der Abhängigkeitseigenschaft angegeben ist.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

SetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die über ihren Bezeichner angegeben wird.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)

Parameter

dp
DependencyProperty

Der Bezeichner der festzulegenden Abhängigkeitseigenschaft.The identifier of the dependency property to set.

value
Object

Der neue lokale Wert.The new local value.

Ausnahmen

Es wurde versucht, eine schreibgeschützte Abhängigkeitseigenschaft oder eine Eigenschaft eines versiegelten DependencyObject zu ändern.Attempted to modify a read-only dependency property, or a property on a sealed DependencyObject.

value entsprach nicht dem für die dp-Eigenschaft registrierten Typ.value was not the correct type as registered for the dp property.

Hinweise

Wenn der angegebene Typ nicht mit dem Typ identisch ist, der für die Abhängigkeits Eigenschaft deklariert wurde, weil er ursprünglich registriert wurde, wird eine Ausnahme ausgelöst.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. Der Parameter "value" sollte immer als geeigneter Typ angegeben werden.The value parameter should always be provided as the appropriate type.

Die Ausnahmebedingungen werden potenziell durch den ValidateValueCallback-Rückruf beeinflusst, der im Bezeichner der Abhängigkeits Eigenschaft der festgelegten Abhängigkeits Eigenschaft vorhanden ist.The exception conditions are potentially influenced by the ValidateValueCallback callback that exists on the dependency property identifier of the dependency property being set. Andernfalls können bei dem bereitgestellten Wert allgemeine Typüberprüfungen fehlschlagen (z. b. das Übergeben einer Zeichenfolge, wenn der Native Typ Double ist).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)

Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey-Bezeichner der Abhängigkeitseigenschaft angegeben ist.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)

Parameter

key
DependencyPropertyKey

Der DependencyPropertyKey-Bezeichner der festzulegenden Eigenschaft.The DependencyPropertyKey identifier of the property to set.

value
Object

Der neue lokale Wert.The new local value.

Beispiele

Im folgenden Beispiel wird eine schreibgeschützte Abhängigkeits Eigenschaft zusammen mit einer public static readonly-DependencyProperty definiert, die die erforderliche schreibgeschützte bereit barkeit für eigenschaftenconsumer und den Get-Accessor für den CLRCLR-Wrapper bereitstellt.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

Hinweise

Diese Signatur wird in der Regel verwendet, wenn Sie Werte für schreibgeschützte Abhängigkeits Eigenschaften festlegen, die von Ihren benutzerdefinierten Klassen definiert werden.This signature is generally used when you set values for read-only dependency properties that are defined by your custom classes. Im Allgemeinen wird SetValue nur von dem Typ aufgerufen, der diese Abhängigkeits Eigenschaft registriert hat, die die interne Logik implementiert, die den festgelegten Wert für die Abhängigkeits Eigenschaft bereitstellt.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. Weitere Informationen finden Sie unter Schreibgeschützte Abhängigkeitseigenschaften.For more information, see Read-Only Dependency Properties.

Wenn der angegebene Typ nicht mit dem Typ identisch ist, der für die Abhängigkeits Eigenschaft deklariert wurde, weil er ursprünglich registriert wurde, wird eine Ausnahme ausgelöst.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. Der Parameter "value" sollte immer als geeigneter Typ angegeben werden.The value parameter should always be provided as the appropriate type. Die Ausnahmebedingungen werden potenziell durch den ValidateValueCallback-Rückruf beeinflusst, der im Bezeichner der Abhängigkeits Eigenschaft der festgelegten Abhängigkeits Eigenschaft vorhanden ist.The exception conditions are potentially influenced by the ValidateValueCallback callback that exists on the dependency property identifier of the dependency property being set.

Gilt für: