Partilhar via


PropertyPath.Path Propriedade

Definição

Obtém ou define a cadeia de caracteres que descreve o caminho.

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

String

A cadeia de caracteres que descreve o caminho.

Comentários

A cadeia de caracteres contida nesta propriedade tem três significados completamente diferentes, dependendo se um PropertyPath está sendo usado para um caminho de propriedade do modo de origem para uma associação, para um caminho de propriedade de etapa única do modo de destino para um destino de storyboard ou para um caminho complexo para um destino de storyboard.

Se estiver usando isso PropertyPath no modo de origem para uma associação, Path será uma cadeia de caracteres que representa um nome de propriedade ou pode ser uma cadeia de caracteres que descreve um caminho "passo a passo" para a propriedade no modelo de objeto CLR do objeto que está sendo usado como a origem de uma associação. Para um caminho de propriedade de associação, o caractere que identifica uma "etapa" é um ponto (.). Também há suporte para referências do indexador (incluindo vários indexadores e diferenciação de tipo). Para obter mais detalhes sobre a sintaxe da cadeia de caracteres, conforme usado especificamente pelo Binding objeto, consulte Binding.Path. Uma propriedade usada como fonte de associação não precisa ser uma propriedade de dependência. Se a associação for atualizada bidirecionalmente, a fonte da propriedade deverá ser leitura-gravação. Observe também que o destino de associação precisa ser uma propriedade de dependência. Para obter detalhes, confira a visão geral da Associação de Dados.

Se estiver usando isso PropertyPath no modo de destino para um caminho de etapa única para um destino de storyboard, PropertyPath será uma cadeia de caracteres que é um typeName.cadeia de caracteres de nome da propriedade de dependência qualificada property.propertyName.

Se estiver usando isso PropertyPath para um caminho complexo para um destino de storyboard, Path será um formato de cadeia de caracteres tokenizado que descreve as relações dos vários objetos fornecidos no PathParameters.

  • Cada item na matriz é especificado nesse formato pelo índice de matriz do item entre parênteses. Por exemplo, para especificar o primeiro item na matriz, o token de cadeia de caracteres é (0).

  • As relações entre itens ("etapas" no caminho) são especificadas por um ponto (.). O encaminhamento da propriedade do ponto é a primeira etapa no caminho, a propriedade depois é a segunda etapa e assim por diante (você pode especificar etapas além de duas). A última etapa na cadeia sempre representa a propriedade que está sendo animada.

  • Os itens dentro das propriedades de coleção são acessados com uma sintaxe do indexador, com o índice dentro de colchetes ([ e ]). O indexador é aditivo ao token que representa a propriedade. Por exemplo, o seguinte é um caminho de duas etapas, com a combinação de token na primeira etapa especificando o segundo item de dentro da coleção dessa propriedade: (0)[1].(1) . Você não pode usar um indexador na última propriedade na cadeia; você não pode animar a posição real da coleção, você deve animar uma propriedade nesse objeto.

A cadeia de caracteres de caminho para um PropertyPath é normalmente estabelecida por meio dos construtores: a PropertyPath(Object) assinatura para associações ou destinos de storyboard de etapa única, a PropertyPath(String, Object[]) assinatura para destinos de storyboard de várias etapas.

XAML: Quando você usa uma PropertyPath para descrever uma referência de propriedade em XAML, como um valor de atributo, a cadeia de caracteres especificada é manipulada pela primeira vez por um conversor de tipo (PropertyPathConverter). Esse conversor de tipo processa a cadeia de caracteres e, com base em sua sintaxe, chamará uma das assinaturas do PropertyPath construtor. Essa indireção por meio do conversor de tipo que manipula um valor de atributo geralmente é como você usa PropertyPath em XAML, em vez de declarar um PropertyPath elemento de objeto e, em seguida, aplicar valores específicos a atributos como Path e PathParameters. Para obter mais informações, consulte a Sintaxe XAML do PropertyPath.

Uso de texto XAML

Os membros do PropertyPath tipo normalmente não são definidos em uma sintaxe XAML direta. Consulte Observações.

Aplica-se a