DependencyObject.ReadLocalValue(DependencyProperty) Metoda

Definicja

Zwraca wartość lokalną właściwości zależności, jeśli istnieje.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

Parametry

dp
DependencyProperty

DependencyProperty identyfikator właściwości, dla której ma zostać pobrana wartość.The DependencyProperty identifier of the property to retrieve the value for.

Zwraca

Zwraca wartość lokalną lub zwraca wartość wskaźnikową UnsetValue, jeśli nie ustawiono żadnej wartości lokalnej.Returns the local value, or returns the sentinel value UnsetValue if no local value is set.

Uwagi

Należy używać GetValue dla większości typowych operacji "Get" dla właściwości zależności.You should use GetValue for most typical "get" operations for a dependency property. ReadLocalValue nie zwraca wartości efektywnej dla różnych przypadków, w których wartość nie została ustawiona lokalnie.ReadLocalValue does not return the effective value for a variety of circumstances where the value was not locally set.

Wartości, które są ustawiane przez style, motywy, szablony, wartość domyślną z metadanych lub dziedziczenia wartości właściwości, nie są uznawane za wartości lokalne.Values that are set by styles, themes, templates, the default value from metadata, or property value inheritance are not considered to be local values. Jednakże powiązania i inne wyrażenia są uznawane za wartości lokalne po ich ocenie.However, bindings and other expressions are considered to be local values, after they have been evaluated.

Gdy wartość lokalna nie jest ustawiona, ta metoda zwraca UnsetValue.When no local value is set, this method returns UnsetValue.

Jeśli zwracana wartość jest inna niż UnsetValue, można wysłać zapytanie do metadanych żądanej właściwości zależności, aby określić, czy istnieje bardziej konkretny typ, do którego można przekonwertować wartość zwracaną.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.

Dotyczy

Zobacz też