DependencyObject.SetValue(DependencyProperty, Object) 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 für ein DependencyObject fest.
public:
virtual void SetValue(DependencyProperty ^ dp, Platform::Object ^ value) = SetValue;void SetValue(DependencyProperty const& dp, IInspectable const& value);public void SetValue(DependencyProperty dp, object value);function setValue(dp, value)Public Sub SetValue (dp As DependencyProperty, value As Object)Parameter
Der Bezeichner der festzulegenden Abhängigkeitseigenschaft.
- value
-
Object
Platform::Object
IInspectable
Der neue lokale Wert.
Hinweise
Wenn der angegebene Werttyp nicht mit dem Typ übereinstimmt, der für die Abhängigkeitseigenschaft deklariert wird, da er ursprünglich registriert wurde, wird eine Ausnahme ausgelöst.
Nicht alle Windows-Runtime Eigenschaften, die von XAML verwendet werden, sind Abhängigkeitseigenschaften. Ein DependencyProperty-Bezeichner muss vorhanden sein, und er muss als öffentliche Eigenschaft eines besitzenden Objekts verfügbar sein, in der Regel das Objekt, das die Eigenschaft registriert hat.
Für App-Benutzercode ist der Aufruf SetValue in der Regel nicht erforderlich. In der Regel verfügt eine Windows-Runtime Abhängigkeitseigenschaft oder eine benutzerdefinierte Abhängigkeitseigenschaft über eine konventionelle Eigenschaft, die sie umschließt, und Sie können den Eigenschaftswert einfach über eine herkömmliche gepunktete Verwendung festlegen. Die folgenden Fälle können Sie möglicherweise noch verwenden SetValue :
- Sie definieren eine benutzerdefinierte Abhängigkeitseigenschaft. Sie rufen im
SetValueRahmen der Definition Ihres eigenen Eigenschaftssatz-Accessors für eine konventionelle Eigenschaftsnutzung auf. Weitere Informationen finden Sie unter Benutzerdefinierte Abhängigkeitseigenschaften. - Sie definieren einen Rückruf oder befinden sich in einem anderen Bereich, in dem Bereits ein DependencyProperty-Bezeichner übergeben wird, und es ist möglich, dass mehrere Abhängigkeitseigenschaften vorhanden sind, mit denen Sie in diesem Bereich interagieren möchten. In diesen Fällen ist es wahrscheinlich einfacher, den Bezeichner zu übergeben
SetValue.