Condividi tramite

Direttiva x:Uid

  • Articolo

Fornisce un identificatore univoco per gli elementi di markup. In molti scenari, questo identificatore univoco viene usato dai processi e dagli strumenti di localizzazione XAML.

Utilizzo degli attributi XAML

<object x:Uid="identifier"... />

Valori XAML

Valore Descrizione
identifier Stringa creata o generata automaticamente che deve essere univoca in un file quando viene interpretata da un consumer x:Uid.

Osservazioni

In [MS-XAML], x:Uid è definito come direttiva. Per altre informazioni, vedere [MS-XAML] Sezione 7.3.6.

x:Uid è discreto da x:Name sia a causa dello scenario di localizzazione XAML dichiarato che in modo che gli identificatori usati per la localizzazione non abbiano dipendenze dalle implicazioni del modello di programmazione di x:Name. Inoltre, x:Name è governato dall'ambito dei nomi XAML; tuttavia, x:Uid non è governato da alcun concetto di univocità definito dal linguaggio XAML. I processori XAML in senso generale (processori che non fanno parte del processo di localizzazione) non devono applicare l'univocità dei valori x:Uid. Tale responsabilità è concettualmente sull'origine dei valori. L'aspettativa di univocità dei valori x:Uid all'interno di una singola origine XAML è ragionevole per i consumer dei valori, ad esempio processi o strumenti di globalizzazione dedicati. Il modello di univocità tipico è che x:Uid valori sono univoci all'interno di un file con codifica XML che rappresenta XAML.

Gli strumenti che hanno una conoscenza significativa di uno schema XAML specifico possono scegliere di applicare x:Uid solo per le stringhe localizzabili true, anziché per tutti i casi in cui viene rilevato un valore stringa di testo nel markup.

I framework possono specificare una particolare proprietà nel modello a oggetti come alias per x:Uid applicando l'attributo UidPropertyAttribute al tipo di definizione. Se un framework specifica una determinata proprietà, non è valido specificare sia x:Uid che il membro con alias nello stesso oggetto. Se vengono specificati sia x:Uid che il membro con alias, l'API dei servizi XAML .NET genera in genere XamlDuplicateMemberException per questo caso.

Note sull'utilizzo di WPF

Per altre informazioni sul ruolo di x:Uid nel processo di localizzazione WPF e nel formato BAML di XAML, vedere Globalization for WPF or Uid

Vedere anche