DependencyObject.SetValue Methode

Definition

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest.

Überlädt

SetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch ihren Bezeichner angegeben ist.

SetValue(DependencyPropertyKey, Object)

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

SetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch ihren Bezeichner angegeben ist.

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

Es wurde versucht, eine schreibgeschützte Abhängigkeitseigenschaft oder eine Eigenschaft eines versiegelten DependencyObject zu ändern.

value hatte nicht den richtigen Typ, wie er für die dp-Eigenschaft registriert ist.

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 value Parameter sollte immer als geeigneter Typ angegeben werden.

Die Ausnahmebedingungen werden möglicherweise durch den Rückruf beeinflusst, der ValidateValueCallback für den Abhängigkeitseigenschaftsbezeichner der festzulegenden Abhängigkeitseigenschaft vorhanden ist. Andernfalls schlägt der angegebene Wert möglicherweise allgemeine Bedingungen für die Typüberprüfung fehl (z. B. durch Übergeben einer Zeichenfolge, wenn der systemeigene Typ Double ist).

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 ist.

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 sowie eine public static readonlyDependencyProperty definiert, die die erforderliche schreibgeschützte Exposition für Eigenschaftenverbraucher und den Get-Accessor für den CLR-Wrapper bereitstellt.

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 nur vom Typ aufgerufen, SetValue 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 Schreibgeschützte 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 value Parameter sollte immer als geeigneter Typ angegeben werden. Die Ausnahmebedingungen werden möglicherweise durch den Rückruf beeinflusst, der ValidateValueCallback für den Abhängigkeitseigenschaftsbezeichner der festzulegenden Abhängigkeitseigenschaft vorhanden ist.

Gilt für: