PropertyPath コンストラクター
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
PropertyPath クラスの新しいインスタンスを初期化します。
オーバーロード
| 名前 | 説明 |
|---|---|
| PropertyPath(Object) |
PropertyPath クラスの新しいインスタンスを初期化します。 |
| PropertyPath(String, Object[]) |
指定されたパス トークン文字列とパラメーターを使用して、 PropertyPath クラスの新しいインスタンスを初期化します。 |
PropertyPath(Object)
PropertyPath クラスの新しいインスタンスを初期化します。
public:
PropertyPath(System::Object ^ parameter);
public PropertyPath(object parameter);
new System.Windows.PropertyPath : obj -> System.Windows.PropertyPath
Public Sub New (parameter As Object)
パラメーター
- parameter
- Object
共通言語ランタイム (CLR) プロパティへのパスまたは単一の依存関係プロパティを記述するプロパティ パス。
注釈
このコンストラクターには、バインディングのソース モード プロパティ パスに使用するか、ストーリーボード ターゲットのターゲット モードのシングルステップ プロパティ パスに使用するかによって、まったく異なる 2 つの使用法があります。
バインディングのソース モードでこの PropertyPath を使用する場合、 parameter はプロパティ名を表す文字列であるか、バインディングのソースとして使用されているオブジェクトの CLR オブジェクト モデルのプロパティへの "ステップスルー" パスを記述する文字列にすることができます。 バインディング プロパティ パスの場合、"step" を識別する文字はドット (.) です。 インデクサー参照 (複数のインデクサー、型の区別を含む) もサポートされています。
Binding オブジェクトで特に使用される文字列の構文の詳細については、Binding.Pathを参照してください。 バインディング ソースとして使用されるプロパティは、依存関係プロパティである必要はありません。 バインディングが双方向で更新される場合、参照されるプロパティは読み取り/書き込みである必要があります。 また、バインディング ターゲットは依存関係プロパティである必要があることにも注意してください。 詳細については、「データ バインディングの概要」を参照してください。
この PropertyPath をストーリーボード ターゲットの単一ステップ パスのターゲット モードで使用する場合、通常、 parameter は型 DependencyPropertyとして提供されます。
Nameである文字列を指定することもできます。 これらはどちらも、文字列として内部的に格納されるため、同じ結果に評価されます。 指定された DependencyProperty は、 DependencyPropertyConverterを介して文字列に変換されます。
DependencyPropertyConverterでは、依存関係プロパティの修飾された名前付け形式がサポートされているため、typeName を指定できます。propertyName 修飾依存関係プロパティ名の文字列をコード内のPropertyPath.PropertyPathコンストラクターに指定します。 依存関係プロパティ識別子の修飾パスは、複雑なパスとは異なる概念です。 代わりに、PropertyPath コンストラクターを使用して複雑なパス PropertyPath.PropertyPathを作成する必要があります。
こちらもご覧ください
適用対象
PropertyPath(String, Object[])
指定されたパス トークン文字列とパラメーターを使用して、 PropertyPath クラスの新しいインスタンスを初期化します。
public:
PropertyPath(System::String ^ path, ... cli::array <System::Object ^> ^ pathParameters);
public PropertyPath(string path, params object[] pathParameters);
new System.Windows.PropertyPath : string * obj[] -> System.Windows.PropertyPath
Public Sub New (path As String, ParamArray pathParameters As Object())
パラメーター
- pathParameters
- Object[]
PathParametersを設定するオブジェクトの配列。
注釈
通常、この署名は、複雑なパスを使用するターゲット モードの PropertyPath の使用にのみ使用されます。
このコンストラクターは、params コンストラクター引数のpathParametersをサポートします。 したがって、配列を次元化してpathParameters項目を設定する必要なく、配列を設定する一連のコンマ区切りコンストラクター引数としてpathParametersの内容を指定できます。 指定する各項目は、 DependencyProperty、 PropertyInfo、 PropertyDescriptorのいずれかの種類である必要があります。
パラメーターの要件の詳細については、 Path と PathParametersを参照してください。