Binding.Path Propriedade

Definição

Namespace:

Windows.UI.Xaml.Data

Obtém ou define o caminho para a propriedade de origem da associação.

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

Valor da propriedade

PropertyPath

O caminho da propriedade para a origem da associação.

Exemplos

O XAML a seguir demonstra como definir o Caminho usando a extensão de marcação {Binding}. Para obter a listagem de código completa, consulte o exemplo de associação de dados 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>

O XAML a seguir demonstra como definir o Caminho usando inteiros e indexadores de cadeia de caracteres. Para obter a listagem de código completa, consulte o exemplo de associação de dados XAML.

Observação

No momento, as extensões de componente do Visual C++ (C++/CX) não dão suporte à associação de indexador. Consulte o exemplo para obter uma solução 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>

Comentários

O caminho pode ser uma propriedade direta do objeto de origem ou subpropriedades desse objeto que você percorre usando a sintaxe do caminho da propriedade. Para fontes de dados do Microsoft .NET, os caminhos também podem usar uma sintaxe do indexador para referenciar itens específicos em uma coleção. Para obter detalhes sobre o formato do caminho da propriedade, consulte Sintaxe property-path.

Para definir a fonte de dados como o objeto Source , o caminho deve ser definido com uma cadeia de caracteres vazia ("").

Ao usar a extensão de marcação {Binding}, o valor path pode ser definido usando o argumento imediatamente após a {Binding parte do uso da extensão, você não precisa incluir Path=explicitamente . Por exemplo, {Binding Albums} define o valor Path dessa associação como um PropertyPath construído a partir da cadeia de caracteres "Albums" (nenhuma outra propriedade Binding está definida).

A maioria dos usos de Path envolve a definição de seu valor. Para cenários em que você está obtendo o valor para examinar as propriedades de uma associação existente, o valor PropertyPath.Path contém a cadeia de caracteres que representa o caminho.

Você não pode definir os valores de propriedade de um objeto Binding depois que essa associação tiver sido anexada a um elemento de destino e à propriedade de destino. Se você tentar isso, receberá uma exceção em tempo de execução.

Confira também

• PropertyPath
• Exemplo de associação de dados XAML
• Vinculação de dados em detalhes