Direttiva x:Uid

Fornisce un identificatore univoco per gli elementi di markup. Per piattaforma UWP (Universal Windows Platform) XAML, questo identificatore univoco viene usato dai processi e dagli strumenti di localizzazione XAML, ad esempio l'uso di risorse da un file di risorse con estensione .resw.

Utilizzo attributo XAML

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

Valori XAML

Termine	Descrizione
stringID	Stringa che identifica in modo univoco un elemento XAML in un'app e diventa parte del percorso della risorsa in un file risorse. Vedere la sezione Osservazioni.

Osservazioni:

Usare x:Uid per identificare un elemento oggetto in XAML. In genere questo elemento oggetto è un'istanza di una classe di controllo o di un altro elemento visualizzato in un'interfaccia utente. La relazione tra la stringa usata in x:Uid e le stringhe usate in un file di risorse è che le stringhe del file di risorse sono le stringhe x:Uid seguite da un punto (.) e quindi dal nome di una proprietà specifica dell'elemento da localizzare. Si consideri questo esempio:

<Button x:Uid="GoButton" Content="Go"/>

Per specificare il contenuto per sostituire il testo visualizzato Go, è necessario specificare una nuova risorsa proveniente da un file risorsa. Il file risorsa deve contenere una voce per la risorsa denominata "GoButton.Content". Content in questo caso è una proprietà specifica ereditata dalla classe Button. È anche possibile specificare valori localizzati per altre proprietà di questo pulsante, ad esempio è possibile fornire un valore basato su risorse per "GoButton.FlowDirection". Per altre info su come usare file x:Uid e risorse insieme, vedere Localizzare le stringhe nell'interfaccia utente e nel manifesto del pacchetto dell'app.

La validità delle stringhe che è possibile usare per un valore x:Uid è controllata in senso pratico da quali stringhe sono legali come identificatore in un file di risorse e in un percorso di risorsa.

x:Uid è discreto da x:Name sia a causa dello scenario di localizzazione XAML dichiarato, sia 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 dal concetto di ambito dei nomi XAML, mentre l'univocità per x:Uid è controllata dal sistema dell'indice delle risorse del pacchetto (PRI). Per altre informazioni, consultare Sistema di gestione delle risorse.

XAML UWP ha regole leggermente diverse per l'univocità l:Uid rispetto alle tecnologie XAML usate in precedenza. Per XAML UWP è legale che lo stesso valore id x:Uid esista come direttiva su più elementi XAML. Tuttavia, ogni elemento deve quindi condividere la stessa logica di risoluzione quando si risolvono le risorse in un file di risorse. Inoltre, tutti i file XAML in un progetto condividono un singolo ambito di risorsa ai fini della risoluzione x:Uid, non esiste alcun concetto di ambiti x:Uid allineati ai singoli file XAML.

In alcuni casi si userà un percorso di risorsa anziché la funzionalità predefinita del sistema PRI (Package Resource Index). Qualsiasi stringa usata come valore x:Uid definisce un percorso di risorsa che inizia con ms-resource:///Resources/ e include la stringa x:Uid. Il percorso viene completato dai nomi delle proprietà specificate in un file di risorse o in caso contrario la destinazione.

Non inserire x:Uid negli elementi della proprietà, che non è consentito in XAML di Windows Runtime.