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

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

Ausnahmen

Hinweise

Wenn es sich bei der bereitgestellte Typ nicht mit den Typ übereinstimmt, der für die Abhängigkeitseigenschaft deklariert wird, wie es 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. Die value Parameter sollte immer den entsprechenden Typ angegeben werden.The value parameter should always be provided as the appropriate type.

Die Ausnahmebedingungen möglicherweise beeinflusst die ValidateValueCallback Rückruf, der auf den Bezeichner der festzulegenden Abhängigkeitseigenschaft Abhängigkeitseigenschaft 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 kann der angegebene Wert ein Fehler auf allgemeine Typprüfung Bedingungen (z. B. eine Zeichenfolge übergeben, wenn der systemeigene Typ Double-Wert ist).Otherwise, the value provided might be failing general type-checking conditions (for example, passing a string when the native type is Double).

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

Beispiele

Das folgende Beispiel definiert eine schreibgeschützte Abhängigkeitseigenschaft zusammen mit einem public static readonly DependencyProperty bereitstellt erforderlichen nur-Lese Kenntnisse in Bezug auf Abfragen der Eigenschaft bereitstellt, und die Get-Accessor für die 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

Hinweise

Diese Signatur wird in der Regel verwendet, wenn Sie Werte für schreibgeschützte Abhängigkeitseigenschaften festlegen, die durch die 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 SetValue heißt nur anhand des Typs, der die Abhängigkeitseigenschaft registriert die interne Logik implementiert, die den festgelegten Wert für die Abhängigkeitseigenschaft 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 es sich bei der bereitgestellte Typ nicht mit den Typ übereinstimmt, der für die Abhängigkeitseigenschaft deklariert wird, wie es 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. Die value Parameter sollte immer den entsprechenden Typ angegeben werden.The value parameter should always be provided as the appropriate type. Die Ausnahmebedingungen möglicherweise beeinflusst die ValidateValueCallback Rückruf, der auf den Bezeichner der festzulegenden Abhängigkeitseigenschaft Abhängigkeitseigenschaft 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.