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

O caminho para a fonte de ligação. A predefinição é null.

Exemplos

O exemplo seguinte mostra um disparador de estilo que cria uma ToolTip e que reporta uma mensagem de erro de validação. O valor do setter liga-se ao conteúdo de erro da corrente TextBox (usando TextBox o estilo) usando a RelativeSource propriedade. Para mais informações sobre este exemplo, veja Como: Implementar a Validação de Vinculaçã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>

Observações

Cada ligação normalmente tem estes quatro componentes: um objeto alvo de ligação, uma propriedade alvo, uma fonte de ligação e um caminho para o valor na fonte de ligação a utilizar. Para mais informações sobre estes conceitos de ligação de dados, consulte Visão Geral da Ligação de Dados.

Use a Path propriedade para especificar o valor de origem ao qual pretende vincular:

• No caso mais simples, o Path valor da propriedade é o nome da propriedade do objeto fonte a usar para a ligaçã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 ligação à subpropriedade Order do objeto ou propriedade ShoppingCart.

• Para vincular a uma propriedade anexa, coloque parênteses à volta da propriedade anexada. Por exemplo, para ligar à propriedade DockPanel.Dockanexada , a sintaxe é Path=(DockPanel.Dock).

• Os indexadores de uma propriedade podem ser especificados entre parênteses após o nome da propriedade onde o indexador é aplicado. Por exemplo, a cláusula Path=ShoppingCart[0] define a ligação ao índice que corresponde à forma como a indexação interna da sua propriedade lida com a cadeia literal "0". Também são suportados múltiplos indexadores.

• Indexadores e subpropriedades podem ser misturados numa Path oração; por exemplo, Path=ShoppingCart.ShippingInfo[MailingAddress,Street].

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

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

• Nomes de propriedades e barras podem ser combinados para atravessar propriedades que são coleções. Por exemplo, Path=/Offices/ManagerName especifica o item atual da coleção de código-fonte, que contém uma Offices propriedade que também é uma coleção. O seu item atual é um objeto que contém uma ManagerName propriedade.

• Opcionalmente, pode ser usado um caminho de período (.) para se ligar à fonte de corrente. Por exemplo, Text="{Binding}" é equivalente a Text="{Binding Path=.}".

Para informações sobre a sintaxe do caminho, consulte a Visão Geral das Declarações de Vinculação ou a Sintaxe PropertyPath XAML.

Para ligações XML, veja a XPath propriedade.

Para ligar a um objeto inteiro, não precisa de especificar a Path propriedade. Para mais informações, consulte "Especificar o Caminho até ao Valor" em Visão Geral de Ligação de Dados.