DependencyObject.GetValue(DependencyProperty) メソッド

定義

DependencyObject から依存関係プロパティの現在の有効な値を返します。

C#
public object GetValue(DependencyProperty dp);

パラメーター

dp
DependencyProperty

値を取得するプロパティの DependencyProperty 識別子。

戻り値

Object

現在の有効値を返します。

注釈

GetValue は、依存関係プロパティの現在の有効な値を取得します。 現在の有効な値は、 依存関係プロパティの概要のルールを使用して決定されます。

GetValue は、ほとんどの場合、プロパティ値を取得するためにプロパティ システム API を使用している場合に必要な API です。 ただし、特定のプロパティに対して依存関係プロパティの優先順位がどのように機能するかを確認するために、他の値を調べることが必要な場合があります。 その場合は、次のいずれかの API を使用できます。

  • 現在アニメーション化されている可能性があるが、アニメーションが実行される前に値を知りたい値を取得するには、GetAnimationBaseValue を使用します。 HoldEnd 動作を持つアニメーションには、この値が同じではない可能性があることに注意してください。 HoldEnd の概念の詳細については、「ストーリーボード化されたアニメーション」を参照してください。
  • ReadLocalValue : スタイルやテンプレート、アニメーションが適用されていないローカル値を取得します。 バインドはローカル値としてカウントされますが、 ReadLocalValue を呼び出すタイミングによっては、動作するバインディング コンテキストがまだ使用できない可能性があるため、実行時に適用されるのと同じ値は取得されません。 依存関係プロパティの優先順位とその他のプロパティ システム ユーティリティ API の詳細については、「 依存関係プロパティの概要」を参照してください。

適用対象

製品 バージョン
Windows App SDK 0.8, 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6

こちらもご覧ください