Freigeben über


DependencyObject.SetValue(DependencyProperty, Object) Methode

Definition

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

dp
DependencyProperty

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 SetValue Rahmen 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.

Gilt für:

Weitere Informationen