Binding.Path Propriedade

Definição

Obtém ou define o caminho para a propriedade de origem de 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

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 indexadores inteiros e de cadeia de caracteres. Para obter a listagem de código completa, consulte o exemplo de associação de dados XAML.

<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 sub-propriedades desse objeto que você percorre usando a sintaxe do caminho da propriedade. Para Microsoft .NET fontes de dados, os caminhos também podem usar uma sintaxe do indexador para fazer referência a 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 De origem , o caminho deve ser definido com uma cadeia de caracteres vazia ("").

Ao usar a extensão de marcação {Binding}, o valor de caminho 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 sendo um PropertyPath construído a partir da cadeia de caracteres "Álbuns" (nenhuma outra propriedade Binding está definida).

A maioria dos usos do Path envolve a definição de seu valor. Para cenários em que você está recebendo 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.

Não é possível 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, obterá uma exceção em tempo de execução.

Aplica-se a

Confira também