Binding.Path Propriedade

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

Valor da propriedade

O caminho para a origem da associação. O padrão é null.

Exemplos

O exemplo a seguir mostra um gatilho de estilo que cria um ToolTip que relata uma mensagem de erro de validação. O valor do setter se associa ao conteúdo de erro do atual TextBox (o uso do TextBox estilo) usando a RelativeSource propriedade. Para obter mais informações sobre este exemplo, consulte Como implementar a validação de associação.

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

Comentários

Cada associação normalmente tem esses quatro componentes: um objeto de destino de associação, uma propriedade de destino, uma origem de associação e um caminho para o valor na fonte de associação a ser usada. Para obter mais informações sobre esses conceitos de associação de dados, consulte Visão geral da Associação de Dados.

Use a Path propriedade para especificar o valor de origem ao qual você deseja associar:

• No caso mais simples, o valor da Path propriedade é o nome da propriedade do objeto de origem a ser usado para a associação, como Path=PropertyName.

• Subpropriedades de uma propriedade podem ser especificadas por uma sintaxe semelhante à usada em C#. Por exemplo, a cláusula Path=ShoppingCart.Order define a associação à subpropriedade Order do objeto ou da propriedade ShoppingCart.

• Para associar a uma propriedade anexada, coloque parênteses ao redor da propriedade anexada. Por exemplo, para associar à propriedade DockPanel.Dockanexada, a sintaxe é Path=(DockPanel.Dock).

• Indexadores de uma propriedade podem ser especificados dentro de colchetes após o nome da propriedade em que o indexador é aplicado. Por exemplo, a cláusula Path=ShoppingCart[0] define a associação ao índice que corresponde à forma como a indexação interna da sua propriedade manipula a cadeia de caracteres literal "0". Também há suporte para vários indexadores.

• Indexadores e subpropriedades podem ser misturados em uma Path cláusula; por exemplo, Path=ShoppingCart.ShippingInfo[MailingAddress,Street].

• Dentro dos indexadores, você pode ter vários parâmetros de indexador separados por vírgulas (,). O tipo de cada parâmetro pode ser especificado com parênteses. Por exemplo, você pode ter Path="[(sys:Int32)42,(sys:Int32)24]", onde sys é mapeado para o System namespace.

• Quando a origem é uma exibição de coleção, o item atual pode ser especificado com uma barra (/). Por exemplo, a cláusula Path=/ define a associação ao item atual na exibição. Quando a origem é uma coleção, essa sintaxe especifica o item atual da exibição de coleção padrão.

• Nomes de propriedades e barras podem ser combinados para percorrer propriedades que são coleções. Por exemplo, Path=/Offices/ManagerName especifica o item atual da coleção de origem, que contém uma Offices propriedade que também é uma coleção. Seu item atual é um objeto que contém uma ManagerName propriedade.

• Opcionalmente, um caminho de ponto (.) pode ser usado para associar à origem atual. Por exemplo, Text="{Binding}" é equivalente a Text="{Binding Path=.}".

Para obter informações sobre a sintaxe do caminho, consulte Visão geral de declarações de associação ou sintaxe XAML do PropertyPath.

Para associações XML, consulte a XPath propriedade.

Para associar a um objeto inteiro, você não precisa especificar a Path propriedade. Para obter mais informações, consulte "Especificando o caminho para o valor" na visão geral da associação de dados.