DependencyObject.SetValue Methode

  • Referenz

Definition

Namespace:
System.Windows
Assembly:
WindowsBase.dll

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest.

Überlädt

SetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch den Bezeichner der Abhängigkeitseigenschaft angegeben wird.
SetValue(DependencyPropertyKey, Object)

Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey Bezeichner der Abhängigkeitseigenschaft angegeben wird.

SetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch den Bezeichner der Abhängigkeitseigenschaft angegeben wird.

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.

value
Object

Der neue lokale Wert.

Ausnahmen

InvalidOperationException

Es wurde versucht, eine schreibgeschützte Abhängigkeitseigenschaft oder eine Eigenschaft für eine versiegelte DependencyObjectzu ändern.

ArgumentException

value war nicht der richtige Typ, der für die dp-Eigenschaft registriert wurde.

Hinweise

Wenn der angegebene Typ nicht mit dem Typ übereinstimmt, der für die Abhängigkeitseigenschaft deklariert wird, wie er ursprünglich registriert wurde, wird eine Ausnahme ausgelöst. Der parameter value sollte immer als der entsprechende Typ angegeben werden.

Die Ausnahmebedingungen werden potenziell durch den ValidateValueCallback Rückruf beeinflusst, der auf dem Bezeichner der Abhängigkeitseigenschaft der festzulegenden Abhängigkeitseigenschaft vorhanden ist. Andernfalls kann der bereitgestellte Wert allgemeine Typenüberprüfungsbedingungen (z. B. Übergeben einer Zeichenfolge, wenn der systemeigene Typ Double ist) fehlschlagen.

Gilt für:

SetValue(DependencyPropertyKey, Object)

Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey Bezeichner der Abhängigkeitseigenschaft angegeben wird.

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.

value
Object

Der neue lokale Wert.

Beispiele

Im folgenden Beispiel wird eine schreibgeschützte Abhängigkeitseigenschaft definiert, zusammen mit einer public static readonlyDependencyProperty, die die erforderliche schreibgeschützte Gefährdung für Eigenschaftenverbraucher und den Zugriff auf den CLR-Wrapper ermöglicht.

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 von Ihren benutzerdefinierten Klassen definiert werden. Im Allgemeinen wird SetValue nur vom Typ aufgerufen, der diese Abhängigkeitseigenschaft registriert hat, wodurch die interne Logik implementiert wird, die den ermittelten Wert für die Abhängigkeitseigenschaft bereitstellt. Weitere Informationen finden Sie unter Read-Only Abhängigkeitseigenschaften.

Wenn der angegebene Typ nicht mit dem Typ übereinstimmt, der für die Abhängigkeitseigenschaft deklariert wird, wie er ursprünglich registriert wurde, wird eine Ausnahme ausgelöst. Der parameter value sollte immer als der entsprechende Typ angegeben werden. Die Ausnahmebedingungen werden potenziell durch den ValidateValueCallback Rückruf beeinflusst, der auf dem Bezeichner der Abhängigkeitseigenschaft der festzulegenden Abhängigkeitseigenschaft vorhanden ist.

Gilt für: