DependencyObject.SetValue Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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
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 readonly
DependencyProperty 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:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für