PropertyPath.Path プロパティ

定義

パスを記述する文字列を取得または設定します。

public:
 property System::String ^ Path { System::String ^ get(); void set(System::String ^ value); };
public string Path { get; set; }
member this.Path : string with get, set
Public Property Path As String

プロパティ値

パスを記述する文字列。

注釈

このプロパティに含まれる文字列は、バインディングのソース モード プロパティ パス、ストーリーボード ターゲットのターゲット モードの単一ステップ プロパティ パス、またはストーリーボード ターゲットの複雑なパスのどちら PropertyPath で が使用されているかによって、まったく異なる 3 つの意味を持ちます。

バインディングのソース モードでこれを PropertyPath 使用する場合、 Path はプロパティ名を表す文字列です。または、バインディングのソースとして使用されているオブジェクトの CLR オブジェクト モデルのプロパティへの "ステップスルー" パスを記述する文字列を指定できます。 バインディング プロパティ パスの場合、"step" を識別する文字はドット (.) です。 インデクサー参照 (複数のインデクサーや型の区別を含む) もサポートされています。 オブジェクトで特に使用 Binding される文字列の構文の詳細については、「」を参照してください Binding.Path。 バインディング ソースとして使用されるプロパティは、依存関係プロパティである必要はありません。 バインドが双方向に更新される場合、プロパティ ソースは読み取り/書き込みである必要があります。 また、バインディング ターゲットは依存関係プロパティである必要があることにも注意してください。 詳細については、「データ バインドの概要」を参照してください。

ストーリーボード ターゲットの単一ステップ パスに対してターゲット モードでこれを PropertyPath 使用する場合、 PropertyPathtypeName の文字列です。propertyName 修飾依存関係プロパティ名文字列。

ストーリーボード ターゲットの複雑なパスにこれを PropertyPath 使用する場合、 Path は、 で PathParameters指定されたさまざまなオブジェクトの関係を記述するトークン化された文字列形式です。

  • 配列内の各項目は、かっこで囲まれた項目の配列インデックスによって、この形式で指定されます。 たとえば、配列内の最初の項目を指定するには、文字列トークンは です (0)

  • 項目間のリレーションシップ (パス内の "ステップ") は、ドット (.) で指定されます。 ドットの前方のプロパティはパスの最初のステップ、次のプロパティは 2 番目のステップです (2 を超えるステップを指定できます)。 チェーンの最後のステップは、アニメーション化されるプロパティを常に表します。

  • コレクション プロパティ内の項目には、インデクサー構文を使用してアクセスします。インデックスは角かっこ ([ と ]) 内にあります。 インデクサーは、 プロパティを表すトークンに加算されます。 たとえば、次の 2 つの手順のパスを示します。最初の手順では、そのプロパティのコレクション内から 2 番目の項目を指定するトークンの組み合わせがあります。 (0)[1].(1) チェーン内の最後のプロパティでインデクサーを使用することはできません。実際のコレクション位置をアニメーション化することはできません。そのオブジェクトのプロパティをアニメーション化する必要があります。

のパス文字列 PropertyPath は、通常、コンストラクター (バインディングまたはシングルステップ ストーリーボード ターゲットの PropertyPath(Object) シグネチャ、マルチステップ ストーリーボード ターゲットの PropertyPath(String, Object[]) シグネチャ) を介して確立されます。

Xaml: を使用 PropertyPath して XAML のプロパティ参照を属性値として記述する場合、指定した文字列は最初に型コンバーター (PropertyPathConverter) によって処理されます。 この型コンバーターは文字列を処理し、その構文に基づいてコンストラクターシグネチャのいずれかを PropertyPath 呼び出します。 属性値を処理する型コンバーターによるこの間接参照は、通常、オブジェクト要素をPropertyPath宣言してから、 や などのPath属性に特定の値を適用するのではなく、XAML で使用PropertyPathする方法ですPathParameters。 詳細については、「 PropertyPath XAML 構文」を参照してください。

XAML テキストの使用法

型の PropertyPath メンバーは、通常、直接 XAML 構文では設定されません。 「解説」を参照してください。

適用対象