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í formát je null.

Příklady

Následující příklad ukazuje trigger stylu, který vytvoří ToolTip zprávu o chybě ověření. Hodnota setter vytvoří vazbu k chybovému obsahu aktuálního TextBox ( TextBox pomocí stylu) pomocí RelativeSource vlastnosti. Další informace o tomto příkladu najdete 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, kterou chcete 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 té, která se používá v jazyce C#. Klauzule Path=ShoppingCart.Order například nastaví vazbu na subproperty Order objektu nebo vlastnosti ShoppingCart.

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

• Indexery vlastnosti lze zadat v hranatých závorkách za názvem vlastnosti, kde je indexer použit. 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 podproperties se dají směšovat v Path klauzuli, 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 umístění mapované sys 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 vlastností a lomítka lze kombinovat pro procházení vlastností, které jsou kolekcemi. Určuje například Path=/Offices/ManagerName aktuální položku zdrojové kolekce, která obsahuje Offices vlastnost, která je také kolekcí. Jeho 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í s Text="{Binding Path=.}".

Informace o syntaxi cesty naleznete v tématu Přehled deklarací vazby nebo Syntaxe XAML PropertyPath.

Pro vazby XML se podívejte na XPath vlastnost.

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