DependencyObject.ReadLocalValue(DependencyProperty) Methode

Definition

Gibt, sofern vorhanden, den lokalen Wert einer Abhängigkeitseigenschaft zurück.Returns the local value of a dependency property, if it exists.

public:
 System::Object ^ ReadLocalValue(System::Windows::DependencyProperty ^ dp);
public object ReadLocalValue (System.Windows.DependencyProperty dp);
member this.ReadLocalValue : System.Windows.DependencyProperty -> obj
Public Function ReadLocalValue (dp As DependencyProperty) As Object

Parameter

dp
DependencyProperty

Der DependencyProperty-Bezeichner der Eigenschaft, für die der Wert abgerufen wird.The DependencyProperty identifier of the property to retrieve the value for.

Gibt zurück

Gibt den lokalen Wert oder den Sentinelwert UnsetValue zurück, wenn kein lokaler Wert festgelegt ist.Returns the local value, or returns the sentinel value UnsetValue if no local value is set.

Hinweise

Für eine Abhängigkeits Eigenschaft sollten Sie GetValue für die meisten typischen "Get"-Vorgänge verwenden.You should use GetValue for most typical "get" operations for a dependency property. ReadLocalValue gibt den effektiven Wert für eine Vielzahl von Situationen zurück, in denen der Wert nicht lokal festgelegt wurde.ReadLocalValue does not return the effective value for a variety of circumstances where the value was not locally set.

Werte, die durch Stile, Designs, Vorlagen, den Standardwert aus Metadaten oder die Vererbung von Eigenschafts Werten festgelegt werden, werden nicht als lokale Werte betrachtet.Values that are set by styles, themes, templates, the default value from metadata, or property value inheritance are not considered to be local values. Bindungen und andere Ausdrücke werden jedoch als lokale Werte betrachtet, nachdem Sie ausgewertet wurden.However, bindings and other expressions are considered to be local values, after they have been evaluated.

Wenn kein lokaler Wert festgelegt ist, gibt diese Methode UnsetValue zurück.When no local value is set, this method returns UnsetValue.

Wenn der zurückgegebene Wert nicht UnsetValue ist, können Sie die Metadaten der angeforderten Abhängigkeits Eigenschaft Abfragen, um zu bestimmen, ob es einen spezifischeren Typ gibt, in den der Rückgabewert konvertiert werden kann.If the returned value is other than UnsetValue, you can query the metadata of the requested dependency property to determine whether there is a more specific type that the return value can be converted to.

Gilt für:

Siehe auch