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 das Aufrufen von 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. Fälle, in denen Sie SetValue weiterhin verwenden können, sind:
- Sie definieren eine benutzerdefinierte Abhängigkeitseigenschaft. Sie rufen SetValue auf, um Ihren eigenen Eigenschaftssatz-Accessor für eine konventionelle Eigenschaftennutzung zu definieren. 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, SetValue aufzurufen und den Bezeichner zu übergeben.