Binding.Path Proprietà

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

Valore della proprietà

Percorso dell'origine dell'associazione. Il valore predefinito è null.

Esempio

Nell'esempio seguente viene illustrato un trigger di stile che crea un oggetto ToolTip che segnala un messaggio di errore di convalida. Il valore del setter viene associato al contenuto di errore dell'oggetto corrente TextBox (utilizzando TextBox lo stile) utilizzando la RelativeSource proprietà . Per altre informazioni su questo esempio, vedere Procedura: Implementare la convalida dell'associazione.

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

Commenti

Ogni associazione ha in genere questi quattro componenti: un oggetto di destinazione di associazione, una proprietà di destinazione, un'origine di associazione e un percorso al valore nell'origine di associazione da usare. Per altre informazioni su questi concetti relativi al data binding, vedere Panoramica del data binding.

Usare la Path proprietà per specificare il valore di origine a cui si vuole eseguire l'associazione:

• Nel caso più semplice, il Path valore della proprietà è il nome della proprietà dell'oggetto di origine da utilizzare per l'associazione, ad esempio Path=PropertyName.

• Le proprietà secondarie di una proprietà possono essere specificate da una sintassi simile a quella usata in C#. Ad esempio, la clausola Path=ShoppingCart.Order imposta l'associazione sulla sottoproprietà Order dell'oggetto o della proprietà ShoppingCart.

• Per eseguire l'associazione a una proprietà associata, posizionare le parentesi intorno alla proprietà associata. Ad esempio, per eseguire l'associazione alla proprietà DockPanel.Dockassociata , la sintassi è Path=(DockPanel.Dock).

• Gli indicizzatori di una proprietà possono essere specificati tra parentesi quadre dopo il nome della proprietà in cui viene applicato l'indicizzatore. Ad esempio, la clausola Path=ShoppingCart[0] imposta l'associazione sull'indice che corrisponde al modo in cui l'indicizzazione interna della proprietà gestisce la stringa letterale "0". Sono supportati anche più indicizzatori.

• Gli indicizzatori e le sottoproprietà possono essere misti in una Path clausola, ad esempio Path=ShoppingCart.ShippingInfo[MailingAddress,Street].

• All'interno degli indicizzatori è possibile avere più parametri dell'indicizzatore separati da virgole (,). Il tipo di ogni parametro può essere specificato tra parentesi. Ad esempio, è possibile avere Path="[(sys:Int32)42,(sys:Int32)24]", dove sys è mappato allo spazio dei System nomi .

• Quando l'origine è una visualizzazione raccolta, l'elemento corrente può essere specificato con una barra (/). Ad esempio, la clausola Path=/ imposta l'associazione sull'elemento corrente nella visualizzazione. Quando l'origine è una raccolta, questa sintassi specifica l'elemento corrente della visualizzazione raccolta predefinita.

• I nomi e le barre delle proprietà possono essere combinati per attraversare le proprietà raccolte. Ad esempio, Path=/Offices/ManagerName specifica l'elemento corrente dell'insieme di origine, che contiene una Offices proprietà che è anche una raccolta. L'elemento corrente è un oggetto che contiene una ManagerName proprietà .

• Facoltativamente, è possibile usare un percorso punto (.) per eseguire l'associazione all'origine corrente. Ad esempio, Text="{Binding}" equivale a Text="{Binding Path=.}".

Per informazioni sulla sintassi del percorso, vedere Cenni preliminari sulle dichiarazioni di binding o sintassi XAML di PropertyPath.

Per le associazioni XML, vedere la XPath proprietà .

Per eseguire l'associazione a un intero oggetto, non è necessario specificare la Path proprietà . Per altre informazioni, vedere "Specifica del percorso del valore" in Panoramica del data binding.