Binding.Path Proprietà

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Data

Ottiene o imposta il percorso della proprietà di origine di associazione.

public:
 property PropertyPath ^ Path { PropertyPath ^ get(); void set(PropertyPath ^ value); };

PropertyPath Path();

void Path(PropertyPath value);

public PropertyPath Path { get; set; }

var propertyPath = binding.path;
binding.path = propertyPath;

Public Property Path As PropertyPath

<Binding Path="propertyPath"/>

Valore della proprietà

PropertyPath

Percorso della proprietà per l'origine dell'associazione.

Esempio

Il codice XAML seguente illustra come impostare il percorso usando l'estensione di markup {Binding}. Per l'elenco di codice completo, vedi l'esempio di data binding XAML.

<StackPanel Margin="5">

  <TextBlock Text="Name:" Style="{StaticResource DescriptionTextStyle}" 
    Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

  <TextBox Text="{Binding Path=Name, Mode=TwoWay}" 
    Width="350" Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

  <TextBlock Text="Organization:" Style="{StaticResource DescriptionTextStyle}" 
    Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

  <!-- You can omit the 'Path=' portion of the binding expression. -->
  <TextBox Text="{Binding Organization, Mode=TwoWay}" Width="350" 
    Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

</StackPanel>

Il codice XAML seguente illustra come impostare path usando gli indicizzatori di tipo integer e stringhe. Per l'elenco di codice completo, vedi l'esempio di data binding XAML.

Nota

Le estensioni del componente Visual C++ (C++/CX) attualmente non supportano l'associazione dell'indicizzatore. Vedere l'esempio per una soluzione alternativa.

<StackPanel>

  <StackPanel Orientation="Horizontal">

    <TextBlock Text="Team name:" 
      Style="{StaticResource DescriptionTextStyle}" 
      Margin="5" FontWeight="Bold"/>

    <TextBlock Text="{Binding Path=[3].Name}" 
      Style="{StaticResource DescriptionTextStyle}" Margin="5" />

  </StackPanel>

  <StackPanel Orientation="Horizontal">

    <TextBlock Text="Team manager:" 
      Style="{StaticResource DescriptionTextStyle}" 
      Margin="5" FontWeight="Bold"/>

    <TextBlock Text="{Binding Path=[3][Gaffer]}" 
      Style="{StaticResource DescriptionTextStyle}" Margin="5"/>

  </StackPanel>

</StackPanel>

Commenti

Il percorso può essere una proprietà diretta dell'oggetto di origine o le sottoproprietà dell'oggetto a cui si passa utilizzando la sintassi del percorso della proprietà. Per le origini dati Microsoft .NET, i percorsi possono anche usare una sintassi dell'indicizzatore per fare riferimento a elementi specifici in una raccolta. Per informazioni dettagliate sul formato del percorso della proprietà, vedere Sintassi property-path.

Per impostare l'origine dati come oggetto Source , il percorso deve essere definito con una stringa vuota ("").

Quando si usa l'estensione di markup {Binding}, è possibile impostare il valore Path usando l'argomento immediatamente dopo la {Binding parte dell'utilizzo dell'estensione, non è necessario includere Path=in modo esplicito . Ad esempio, {Binding Albums} imposta il valore Path di tale associazione in modo che sia un PropertyPath costruito dalla stringa "Albums" (non sono impostate altre proprietà binding).

La maggior parte degli utilizzi di Path implica l'impostazione del relativo valore. Per gli scenari in cui si ottiene il valore per esaminare le proprietà di un'associazione esistente, il valore PropertyPath.Path contiene la stringa che rappresenta il percorso.

Non è possibile impostare i valori delle proprietà di un oggetto Binding dopo che tale associazione è stata associata a un elemento di destinazione e a una proprietà di destinazione. Se si tenta di ottenere un'eccezione in fase di esecuzione.

Vedi anche

• PropertyPath
• Esempio di data binding XAML
• Informazioni approfondite sul data binding