Binding.Path Vlastnost

Definice

Obor názvů:

System.Windows.Data

Sestavení:

PresentationFramework.dll

Získá nebo nastaví cestu ke zdrojové vlastnosti vazby.

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

Hodnota vlastnosti

PropertyPath

Cesta ke zdroji vazby. Výchozí hodnota je null.

Příklady

Následující příklad ukazuje trigger stylu, který vytvoří ToolTip zprávu o chybě ověření. Hodnota setter se binds to the error content of the current TextBox (the TextBox using the style) using the RelativeSource property. Další informace o tomto příkladu naleznete v tématu Postupy: Implementace ověřování vazby.

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

Poznámky

Každá vazba má obvykle tyto čtyři komponenty: cílový objekt vazby, cílovou vlastnost, zdroj vazby a cestu k hodnotě ve zdroji vazby, který se má použít. Další informace o těchto konceptech datových vazeb najdete v tématu Přehled datových vazeb.

Path Vlastnost použijte k určení zdrojové hodnoty, ke které chcete vytvořit vazbu:

• V nejjednodušším případě Path je hodnota vlastnosti název vlastnosti zdrojového objektu, který se má použít pro vazbu, například Path=PropertyName.

• Podproperties vlastnosti lze zadat syntaxí podobnou syntaxi, která se používá v jazyce C#. Klauzule Path=ShoppingCart.Order například nastaví vazbu na subproperty Order objektu nebo vlastnosti ShoppingCart.

• Chcete-li vytvořit vazbu k připojené vlastnosti, umístěte závorky kolem připojené vlastnosti. Například pro vazbu k připojené vlastnosti DockPanel.Dock, syntaxe je Path=(DockPanel.Dock).

• Indexery vlastnosti lze zadat v hranatých závorkách za názvem vlastnosti, ve které je použit indexer. Klauzule Path=ShoppingCart[0] například nastaví vazbu na index, který odpovídá tomu, jak interní indexování vlastnosti zpracovává literálový řetězec "0". Podporuje se také více indexerů.

• Indexery a dílčí podmínky můžou být v Path klauzuli smíšené, například Path=ShoppingCart.ShippingInfo[MailingAddress,Street].

• Uvnitř indexerů můžete mít více parametrů indexeru oddělených čárkami (,). Typ každého parametru lze zadat pomocí závorek. Můžete Path="[(sys:Int32)42,(sys:Int32)24]"mít například , kde sys je namapován na System obor názvů.

• Pokud je zdrojem zobrazení kolekce, lze aktuální položku zadat lomítkem (/). Klauzule Path=/ například nastaví vazbu na aktuální položku v zobrazení. Pokud je zdrojem kolekce, tato syntaxe určuje aktuální položku výchozího zobrazení kolekce.

• Názvy a lomítka lze kombinovat a procházet vlastnosti, které jsou kolekcemi. Path=/Offices/ManagerName Například určuje aktuální položku zdrojové kolekce, která obsahuje Offices vlastnost, která je také kolekcí. Její aktuální položka je objekt, který obsahuje ManagerName vlastnost.

• Volitelně lze použít cestu tečky (.) k vytvoření vazby k aktuálnímu zdroji. Například Text="{Binding}" je ekvivalentní .Text="{Binding Path=.}"

Informace o syntaxi cesty naleznete v tématu Přehled deklarací vazeb nebo Syntaxe XAML Cesty k vlastnostem.

Pro vazby XML se podívejte na XPath vlastnost.

Pokud chcete vytvořit vazbu k celému objektu, nemusíte zadávat Path vlastnost. Další informace naleznete v tématu "Určení cesty k hodnotě" v přehledu datových vazeb.