Binding.Path Eigenschaft

Definition

Namespace:

System.Windows.Data

Assembly:

PresentationFramework.dll

Ruft den Pfad zur Bindungsquelleneigenschaft fest ab oder legt diesen fest.

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

Eigenschaftswert

PropertyPath

Der Pfad zur Bindungsquelle. Der Standardwert ist null.

Beispiele

Das folgende Beispiel zeigt einen Stiltrigger, der einen ToolTip erstellt, der eine Validierungsfehlermeldung meldet. Der Wert des Setters bindet mithilfe der -Eigenschaft an den RelativeSource Fehlerinhalt des aktuellen TextBox (derTextBox, der die Formatvorlage verwendet). Weitere Informationen zu diesem Beispiel finden Sie unter Vorgehensweise: Implementieren der Bindungsüberprüfung.

<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>

Hinweise

Jede Bindung verfügt in der Regel über diese vier Komponenten: ein Bindungszielobjekt, eine Zieleigenschaft, eine Bindungsquelle und einen Pfad zum Wert in der zu verwendenden Bindungsquelle. Weitere Informationen zu diesen Datenbindungskonzepten finden Sie unter Übersicht über die Datenbindung.

Verwenden Sie die Path-Eigenschaft, um den Quellwert anzugeben, an den Sie binden möchten:

• Im einfachsten Fall ist der Path-Eigenschaftswert der Name der Eigenschaft des Quellobjekts, das für die Bindung verwendet wird, beispielsweise Path=PropertyName.

• Untereigenschaften einer Eigenschaft können durch eine Syntax ähnlich der in C# verwendeten angegeben werden. So legt zum Beispiel die Klausel Path=ShoppingCart.Order die Bindung für die untergeordnete Order-Eigenschaft des Objekts oder die ShoppingCart-Eigenschaft fest.

• Um eine angefügte Eigenschaft zu binden, schließen Sie die angefügte Eigenschaft in Klammern ein. Um beispielsweise eine Bindung an die angefügte Eigenschaft DockPanel.Dock zu erstellen, gilt folgende Syntax Path=(DockPanel.Dock).

• Indexer einer Eigenschaft können durch eckige Klammern nach dem Namen der indizierten Eigenschaft angegeben werden. So legt zum Beispiel die Path=ShoppingCart[0]-Klausel die Bindung auf den Index fest, der der Art und Weise entspricht, wie die interne Indizierung der Eigenschaft das Zeichenfolgenliteral „0“ handhabt. Mehrere Indexer werden ebenfalls unterstützt.

• Indexer und untergeordnete Eigenschaften können in einer Path-Klausel kombiniert werden, z. B. Path=ShoppingCart.ShippingInfo[MailingAddress,Street]..

• Indexer können mehrere durch Kommata (,) getrennte Indexer-Parameter aufweisen. Der Typ der einzelnen Parameter kann in Klammern angegeben werden. Sie können beispielsweise über Path="[(sys:Int32)42,(sys:Int32)24]" verfügen, wobei sys dem System-Namespace zugeordnet ist.

• Wenn die Quelle eine Auflistungsansicht darstellt, kann das aktuelle Element mit einem Schrägstrich (/) angegeben werden. Beispielsweise legt die Klausel Path=/ die Bindung auf das aktuelle Element in der Ansicht fest. Wenn die Quelle eine Auflistung darstellt, gibt diese Syntax das aktuelle Element der Standardauflistungsansicht an.

• Eigenschaftennamen und Schrägstriche können kombiniert werden, um Eigenschaften zu durchlaufen, die Auflistungen darstellen. Beispielsweise gibt Path=/Offices/ManagerName das aktuelle Element der Quellauflistung an, die eine Offices-Eigenschaft enthält, bei der es sich ebenfalls um eine Auflistung handelt. Bei dem aktuellen Element handelt es sich um ein Objekt, das eine ManagerName-Eigenschaft enthält.

• Optional kann ein Pfad mit einem Punkt (.) für die Bindung an die aktuelle Quelle verwendet werden. Text="{Binding}" entspricht beispielsweise Text="{Binding Path=.}".

Informationen zur Pfadsyntax finden Sie unter Binding Declarations Overview oder PropertyPath XAML Syntax.

Xml-Bindungen finden Sie in der XPath -Eigenschaft.

Um an ein gesamtes Objekt zu binden, müssen Sie die Path -Eigenschaft nicht angeben. Weitere Informationen finden Sie unter Angeben des Pfads zum Wert in der Übersicht über die Datenbindung.