PropertyPath.Path Propriedade

public:
 property System::String ^ Path { System::String ^ get(); void set(System::String ^ value); };

public string Path { get; set; }

member this.Path : string with get, set

Public Property Path As String

Valor de Propriedade

A cadeia que descreve o caminho.

Observações

A cadeia contida nesta propriedade tem três significados completamente diferentes, dependendo se a PropertyPath está a ser usada para um caminho de propriedade em modo fonte para uma ligação, para um caminho de propriedade de um passo em modo alvo para um alvo de storyboard, ou para um caminho complexo para um alvo de storyboard.

Se usar isto PropertyPath em modo fonte para uma ligação, Path é uma cadeia que representa um nome de propriedade, ou pode ser uma cadeia que descreve um caminho "passo" até à propriedade no modelo de objetos CLR do objeto que está a ser usado como fonte para uma ligação. Para um caminho de propriedade de ligação, o carácter que identifica um "passo" é um ponto (.). Referências indexadoras (incluindo múltiplos indexadores e diferenciação de tipos) também são suportadas. Para mais detalhes sobre a sintaxe da cadeia especificamente usada pelo Binding objeto, veja Binding.Path. Uma propriedade usada como fonte de ligação não tem de ser uma propriedade de dependência. Se a ligação for atualizada bidirecionalmente, a fonte da propriedade deve ser leitura-escrita. Note também que o alvo de ligação tem de ser uma propriedade de dependência. Para obter detalhes, consulte Visão geral da vinculação de dados .

Se usar isto PropertyPath em modo alvo para um caminho de passo único para um alvo de storyboard, PropertyPath é uma string que é um typeName.PropertyName qualificado dependência cadeia de nome de propriedade.

Se usar isto PropertyPath para um caminho complexo para um alvo de storyboard, Path é um formato de string tokenizado que descreve as relações dos vários objetos dados no PathParameters.

• Cada item do array é especificado neste formato pelo índice do array para o item incluído entre parênteses. Por exemplo, para especificar o primeiro item do array, o token string é (0).

• As relações entre itens ("passos" no caminho) são especificadas por um ponto (.). A propriedade à frente do ponto é o primeiro passo no caminho, a propriedade seguinte é o segundo passo, e assim sucessivamente (podes especificar passos além de dois). O último passo da cadeia representa sempre a propriedade que está a ser animada.

• Os itens dentro das propriedades da coleção são acedidos com uma sintaxe de indexador, com o índice entre parênteses ([ e ]). O indexador é aditivo ao token que representa a propriedade. Por exemplo, o seguinte é um caminho em dois passos, com a combinação de fichas no primeiro passo a especificar o segundo item dentro da coleção dessa propriedade: (0)[1].(1) . Não pode usar um indexador na última propriedade da cadeia; Não podes animar a posição real da coleção, tens de animar uma propriedade nesse objeto.

A cadeia de caminho para um PropertyPath é normalmente estabelecida através dos construtores: a PropertyPath(Object) assinatura para bindings ou alvos de storyboard de passo único, a PropertyPath(String, Object[]) assinatura para alvos de storyboard de múltiplos passos.

XAML: Quando usa a PropertyPath para descrever uma referência de propriedade em XAML, como valor de atributo, a cadeia que especifica é primeiro tratada por um conversor de tipos (PropertyPathConverter). Este conversor de tipos processa então a cadeia e, com base na sua sintaxe, chama uma das PropertyPath assinaturas do construtor. Esta indireção através do conversor de tipos que trata um valor de atributo é geralmente como se usa PropertyPath em XAML, em vez de declarar um PropertyPath elemento objeto e depois aplicar valores específicos a atributos como Path e PathParameters. Para mais informações, consulte Sintaxe PropertyPath XAML.

Utilização de Texto XAML

Os membros do PropertyPath tipo normalmente não são definidos numa sintaxe XAML direta. Ver Observações.