DependencyObject.SetValue(DependencyProperty, Object) Methode

Definition

Namespace:
Microsoft.UI.Xaml
Bearbeiten

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, wie 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 muss als öffentliche Eigenschaft eines eigenen 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 herkömmliche Eigenschaft, die sie umschließt, und Sie können den Eigenschaftswert einfach über eine herkömmliche gepunktete Verwendung festlegen. Fälle, in denen Sie möglicherweise noch verwenden SetValue , sind:

  • Sie definieren eine benutzerdefinierte Abhängigkeitseigenschaft. Sie rufen SetValue als Teil der Definition Ihres eigenen Eigenschaftensatz-Accessors für eine herkömmliche Eigenschaftsnutzung auf. Weitere Informationen finden Sie unter Benutzerdefinierte Abhängigkeitseigenschaften.
  • Sie definieren einen Rückruf oder befinden sich in einem anderen Bereich, in dem Sie bereits einen DependencyProperty-Bezeichner übergeben werden, 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 aufzurufen SetValue.

Gilt für:

Weitere Informationen