Binding.Path Binding.Path Binding.Path Binding.Path Property

定義

バインディング ソース プロパティへのパスを取得または設定します。Gets or sets the path to the binding source property.

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

プロパティ値

バインディング ソース プロパティへのパス。The path to the binding source. 既定値は、null です。The default is null.

次の例は、スタイルのトリガーを作成する、ToolTip検証エラー メッセージを報告します。The following example shows a style trigger that creates a ToolTip that reports a validation error message. 現在のエラー コンテンツに、set アクセス操作子の値をバインドTextBox(、 TextBox 、スタイルを使用して) を使用して、RelativeSourceプロパティ。The value of the setter binds to the error content of the current TextBox (the TextBox using the style) using the RelativeSource property. この例の詳細については、次を参照してください。方法。検証にバインド実装します。For more information on this example, see How to: Implement Binding Validation.

<Style x:Key="textBoxInError" TargetType="{x:Type TextBox}">
  <Style.Triggers>
    <Trigger Property="Validation.HasError" Value="true">
      <Setter Property="ToolTip"
        Value="{Binding RelativeSource={x:Static RelativeSource.Self},
                        Path=(Validation.Errors)/ErrorContent}"/>
    </Trigger>
  </Style.Triggers>
</Style>

注釈

各バインディングは、通常これら 4 つのコンポーネントを: バインディング ターゲット オブジェクト、ターゲット プロパティ、バインディング ソース、および使用するバインディング ソースの値へのパス。Each binding typically has these four components: a binding target object, a target property, a binding source, and a path to the value in the binding source to use. これらのデータ バインディングの概念の詳細については、次を参照してください。データ バインディングの概要します。For more information about these data binding concepts, see Data Binding Overview.

使用して、Pathプロパティにバインドするソース値を指定します。Use the Path property to specify the source value you want to bind to:

  • 最も簡単なケースで、Pathプロパティの値など、バインドに使用するソース オブジェクトのプロパティの名前は、Path=PropertyNameします。In the simplest case, the Path property value is the name of the property of the source object to use for the binding, such as Path=PropertyName.

  • プロパティのサブプロパティは、C# で使用されるような構文で指定できます。Subproperties of a property can be specified by a syntax similar to that used in C#. たとえば、句 Path=ShoppingCart.Order は、バインディングをオブジェクトのサブプロパティ Order またはプロパティ ShoppingCart に設定します。For instance, the clause Path=ShoppingCart.Order sets the binding to the subproperty Order of the object or property ShoppingCart.

  • 添付プロパティにバインドするには、添付プロパティをかっこで囲みます。To bind to an attached property, place parentheses around the attached property. たとえば、添付プロパティにバインドするDockPanel.Dock、構文はPath=(DockPanel.Dock)します。For example, to bind to the attached property DockPanel.Dock, the syntax is Path=(DockPanel.Dock).

  • プロパティのインデクサーは、インデクサーが適用されているプロパティ名の後ろの角かっこ内に指定できます。Indexers of a property can be specified within square brackets following the property name where the indexer is applied. たとえば、句 Path=ShoppingCart[0] は、プロパティの内部インデックスがリテラル文字列「0」を処理する方法に対応するインデックスへのバインディングを設定します。For instance, the clause Path=ShoppingCart[0] sets the binding to the index that corresponds to how your property's internal indexing handles the literal string "0". 複数のインデクサーもサポートします。Multiple indexers are also supported.

  • Path 句ではインデクサーとサブプロパティを混在させることができます。例: Path=ShoppingCart.ShippingInfo[MailingAddress,Street].Indexers and subproperties can be mixed in a Path clause; for example, Path=ShoppingCart.ShippingInfo[MailingAddress,Street].

  • インデクサーの内側には、コンマ (,) で区切られた複数のインデクサー パラメーターを設定できます。Inside indexers you can have multiple indexer parameters separated by commas (,). かっこで囲んで各パラメーターの型を指定できます。The type of each parameter can be specified with parentheses. たとえば、あるPath="[(sys:Int32)42,(sys:Int32)24]"ここで、sysにマップされて、System名前空間。For example, you can have Path="[(sys:Int32)42,(sys:Int32)24]", where sys is mapped to the System namespace.

  • ソースがコレクション ビューの場合は、スラッシュ (/) で、現在の項目を指定できます。When the source is a collection view, the current item can be specified with a slash (/). 句ではたとえば、Path=/ビューの現在の項目にバインディングを設定します。For example, the clause Path=/ sets the binding to the current item in the view. ソースがコレクションである場合は、この構文は、既定のコレクション ビューの現在の項目を指定します。When the source is a collection, this syntax specifies the current item of the default collection view.

  • プロパティは、コレクションを走査するプロパティの名前とスラッシュを結合できます。Property names and slashes can be combined to traverse properties that are collections. たとえば、Path=/Offices/ManagerNameを含むソース コレクションの現在の項目を指定します、Officesコレクションでもあるプロパティ。For example, Path=/Offices/ManagerName specifies the current item of the source collection, which contains an Offices property that is also a collection. 現在の項目が格納しているオブジェクト、ManagerNameプロパティ。Its current item is an object that contains a ManagerName property.

  • 必要に応じて、現在のソースにバインドするピリオド (.) のパスを使用できます。Optionally, a period (.) path can be used to bind to the current source. たとえば、Text="{Binding}" は、Text="{Binding Path=.}" と同じです。For example, Text="{Binding}" is equivalent to Text="{Binding Path=.}".

パスの構文については、次を参照してください。バインディング宣言の概要またはPropertyPath の XAML 構文します。For information about path syntax, see Binding Declarations Overview or PropertyPath XAML Syntax.

XMLXMLバインド」を参照してください、XPathプロパティ。For XMLXML bindings, see the XPath property.

オブジェクト全体にバインドするには指定する必要はありません、Pathプロパティ。To bind to an entire object, you do not need to specify the Path property. 詳細についてを参照してください「を指定するパスを値」データ バインディングの概要します。For more information, see "Specifying the Path to the Value" in Data Binding Overview.

適用対象