Binding.Path Propriedade

Definição

Namespace:

System.Windows.Data

Assembly:

PresentationFramework.dll

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

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

PropertyPath

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

Exemplos

O exemplo a seguir mostra um gatilho de estilo que cria uma ToolTip mensagem de erro de validação. O valor do setter se associa ao conteúdo de erro do atual TextBox (o TextBox uso do 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 fonte 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 a 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 usada 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 com a subpropriedade Order do objeto ou da propriedade ShoppingCart.

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

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

• Os indexadores e as subpropriedades podem ser combinados em uma cláusula Path. 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]", em que sys é mapeado para o namespace System.

• Quando a fonte é 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 no modo de exibição. Quando a fonte é uma coleção, essa sintaxe especifica o item atual da exibição de coleção padrão.

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

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

Para obter informações sobre a sintaxe do caminho, consulte a Visão geral das Declarações de Associação ou a 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.