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.

Uso della sintassi XAML per gli attributi

<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 x:Uid consumer.

Osservazioni

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

x:Uid è discreto sia a x:Name 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 è disciplinato dall'ambito dei nomi XAML, ma x:Uid non è disciplinato 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 x:Uid valori. Tale responsabilità è concettualmente sull'origine dei valori. L'aspettativa di univocità dei valori all'interno di x:Uid 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 i 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 reali, 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 applicando x:Uid l'attributo UidPropertyAttribute al tipo di definizione. Se un framework specifica una particolare 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 XamlDuplicateMemberException in genere per questo caso.

Note sull'utilizzo di WPF

Per altre informazioni sul ruolo di nel processo di x:Uid localizzazione WPF e nel formato BAML di XAML, vedere Globalizzazione per WPF o Uid

Vedi anche