DependencyObject.ReadLocalValue(DependencyProperty) メソッド


ローカルの依存関係プロパティの値を返します (存在する場合)。Returns the local value of a dependency property, if it exists.

 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



値を取得するプロパティの DependencyProperty 識別子。The DependencyProperty identifier of the property to retrieve the value for.


ローカル値を返します。またはローカル値が設定されていない場合は、sentinel 値 UnsetValue を返します。Returns the local value, or returns the sentinel value UnsetValue if no local value is set.


依存関係プロパティの一般的な "get" 操作には、GetValue を使用する必要があります。You should use GetValue for most typical "get" operations for a dependency property. ReadLocalValue は、値がローカルに設定されていないさまざまな状況では、有効な値を返しません。ReadLocalValue does not return the effective value for a variety of circumstances where the value was not locally set.

スタイル、テーマ、テンプレート、メタデータの既定値、またはプロパティ値の継承によって設定された値は、ローカル値とは見なされません。Values that are set by styles, themes, templates, the default value from metadata, or property value inheritance are not considered to be local values. ただし、バインディングやその他の式は、評価後にローカル値と見なされます。However, bindings and other expressions are considered to be local values, after they have been evaluated.

ローカル値が設定されていない場合、このメソッドは UnsetValueを返します。When no local value is set, this method returns UnsetValue.

戻り値が UnsetValue以外の場合は、要求された依存関係プロパティのメタデータを照会して、戻り値を変換できるより具体的な型があるかどうかを判断できます。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.