PropertyPath.Path Proprietà

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

Valore della proprietà

Stringa che descrive il percorso.

Commenti

La stringa contenuta in questa proprietà ha tre significati completamente diversi a seconda che PropertyPath venga usato un oggetto per un percorso di proprietà in modalità origine per un'associazione, per un percorso di proprietà in modalità di destinazione a passaggio singolo per una destinazione dello storyboard o per un percorso complesso per una destinazione dello storyboard.

Se si usa questa PropertyPath proprietà in modalità di origine per un'associazione, Path è una stringa che rappresenta un nome di proprietà o può essere una stringa che descrive un percorso "dettagliato" della proprietà nel modello a oggetti CLR dell'oggetto utilizzato come origine per un'associazione. Per un percorso della proprietà di associazione, il carattere che identifica un "passaggio" è un punto (.). Sono supportati anche i riferimenti all'indicizzatore (inclusi più indicizzatori e differenziazione dei tipi). Per altre informazioni sulla sintassi della stringa, come usato in modo specifico dall'oggetto Binding , vedere Binding.Path. Una proprietà usata come origine di associazione non deve essere una proprietà di dipendenza. Se l'associazione viene aggiornata in due modi, l'origine delle proprietà deve essere di lettura/scrittura. Si noti anche che la destinazione di associazione deve essere una proprietà di dipendenza. Per informazioni dettagliate, vedere panoramica del data binding .

Se si usa questa PropertyPath opzione in modalità di destinazione per un percorso a passaggio singolo per una destinazione dello storyboard, PropertyPath è una stringa di tipoName.propertyName è una stringa di nome della proprietà di dipendenza qualificata.

Se si usa questo PropertyPath valore per un percorso complesso per una destinazione dello storyboard, Path è un formato di stringa con token che descrive le relazioni dei vari oggetti specificati in PathParameters.

• Ogni elemento della matrice viene specificato in questo formato dall'indice della matrice per l'elemento racchiuso tra parentesi. Ad esempio, per specificare il primo elemento nella matrice, il token stringa è (0).

• Le relazioni tra gli elementi ("passaggi" nel percorso) vengono specificate da un punto (.). La proprietà avanti del punto è il primo passaggio del percorso, la proprietà dopo è il secondo passaggio e così via (è possibile specificare i passaggi oltre due). L'ultimo passaggio della catena rappresenta sempre la proprietà animata.

• Gli elementi all'interno delle proprietà della raccolta sono accessibili con una sintassi dell'indicizzatore, con l'indice racchiuso tra parentesi quadre ([ e ]). L'indicizzatore è aggiuntivo per il token che rappresenta la proprietà . Ad esempio, di seguito è riportato un percorso in due passaggi, con la combinazione di token nel primo passaggio che specifica il secondo elemento dall'interno dell'insieme di tale proprietà: (0)[1].(1) . Non è possibile utilizzare un indicizzatore sull'ultima proprietà della catena; non è possibile animare la posizione effettiva della raccolta, è necessario animare una proprietà su tale oggetto.

La stringa di percorso per un PropertyPath oggetto viene in genere stabilita tramite i costruttori: la PropertyPath(Object) firma per le associazioni o le destinazioni dello storyboard a passo singolo, la PropertyPath(String, Object[]) firma per le destinazioni dello storyboard in più passaggi.

XAML: Quando usi un PropertyPath oggetto per descrivere un riferimento a una proprietà in XAML, come valore di attributo, la stringa specificata viene prima gestita da un convertitore di tipi (PropertyPathConverter). Questo convertitore di tipi elabora quindi la stringa e in base alla relativa sintassi chiamerà una delle firme del PropertyPath costruttore. Questo tipo di riferimento indiretto tramite il convertitore di tipi che gestisce un valore di attributo è in genere come si usa PropertyPath in XAML, anziché dichiarare un PropertyPath elemento oggetto e quindi applicare valori specifici agli attributi, ad Path esempio e PathParameters. Per altre informazioni, vedere Sintassi XAML di PropertyPath.

Utilizzo del testo XAML

I membri del PropertyPath tipo non vengono in genere impostati in una sintassi XAML diretta. Vedere la sezione Osservazioni.