Binding.Path Eigenschaft

Definition

Namespace:

System.Windows.Data

Assembly:

PresentationFramework.dll

Dient zum Abrufen oder Festlegen des Pfads zur Bindungsquelleigenschaft.

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 lautet null.

Beispiele

Das folgende Beispiel zeigt einen Formatauslöser, der eine ToolTip Fehlermeldung zur Überprüfung meldet. Der Wert des Setters wird mithilfe der Eigenschaft an den Fehlerinhalt des aktuellen TextBox ( TextBox mithilfe der Formatvorlage) RelativeSource gebunden. Weitere Informationen zu diesem Beispiel finden Sie unter 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>

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 Data Binding Overview.

Verwenden Sie die Path Eigenschaft, um den Quellwert anzugeben, an den Sie eine Bindung herstellen möchten:

• Im einfachsten Fall ist der Path Eigenschaftswert der Name der Eigenschaft des Quellobjekts, das für die Bindung verwendet werden soll, z Path=PropertyName. B. .

• Untereigenschaften einer Eigenschaft können durch eine Syntax angegeben werden, die in C# verwendet wird. Beispielsweise legt die Klausel Path=ShoppingCart.Order die Bindung auf die Untereigenschaft Order des Objekts oder der Eigenschaft ShoppingCartfest.

• Zum Binden an eine angefügte Eigenschaft platzieren Sie Klammern um die angefügte Eigenschaft. Um beispielsweise eine Bindung an die angefügte Eigenschaft DockPanel.Dockzu erstellen, lautet Path=(DockPanel.Dock)die Syntax .

• Indexer einer Eigenschaft können in eckigen Klammern nach dem Eigenschaftennamen angegeben werden, auf den der Indexer angewendet wird. Beispielsweise legt die Klausel Path=ShoppingCart[0] die Bindung an den Index fest, die der Verarbeitung der literalen Zeichenfolge "0" entspricht, die der internen Indizierung Ihrer Eigenschaft entspricht. Mehrere Indexer werden ebenfalls unterstützt.

• Indexer und Untereigenschaften können in einer Path Klausel gemischt werden, z. B. Path=ShoppingCart.ShippingInfo[MailingAddress,Street].

• Innerhalb von Indexern können Mehrere Indexerparameter durch Kommas (,) getrennt werden. Der Typ der einzelnen Parameter kann mit Klammern angegeben werden. Sie können Path="[(sys:Int32)42,(sys:Int32)24]"z. B. haben, wo sys der Namespace zugeordnet System ist.

• Wenn es sich bei der Quelle um eine Sammlungsansicht handelt, 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 es sich bei der Quelle um eine Auflistung handelt, gibt diese Syntax das aktuelle Element der Standardauflistungsansicht an.

• Eigenschaftennamen und Schrägstriche können kombiniert werden, um Eigenschaften zu durchlaufen, die Auflistungen sind. Gibt beispielsweise Path=/Offices/ManagerName das aktuelle Element der Quellauflistung an, das eine Offices Eigenschaft enthält, die auch eine Auflistung ist. Das aktuelle Element ist ein Objekt, das eine ManagerName Eigenschaft enthält.

• Optional kann ein Punktpfad (.) zum Binden an die aktuelle Quelle verwendet werden. Text="{Binding}" entspricht beispielsweise Text="{Binding Path=.}".

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

Informationen zu XML-Bindungen finden Sie in der XPath Eigenschaft.

Um eine Bindung an ein gesamtes Objekt zu erstellen, müssen Sie die Path Eigenschaft nicht angeben. Weitere Informationen finden Sie unter "Angeben des Pfads zum Wert" in der Datenbindungsübersicht.