x:Uid-direktiv

Tillhandahåller en unik identifierare för markeringselement. För Universal Windows Platform (UWP) XAML används den här unika identifieraren av XAML-lokaliseringsprocesser och -verktyg, till exempel att använda resurser från en .resw-resursfil.

XAML-attributanvändning

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

XAML-värden

Begrepp	Description
strängID	En sträng som unikt identifierar ett XAML-element i en app och blir en del av resurssökvägen i en resursfil. Se Kommentarer.

Anmärkningar

Använd x:Uid för att identifiera ett objektelement i XAML. Vanligtvis är det här objektelementet en instans av en kontrollklass eller ett annat element som visas i ett användargränssnitt. Relationen mellan strängen som du använder i x:Uid och strängarna som du använder i en resursfil är att resursfilsträngarna är x:Uid följt av en punkt (.) och sedan med namnet på en specifik egenskap för elementet som lokaliseras. Tänk på det här exemplet:

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

Om du vill ange innehåll som ska ersätta visningstexten Go måste du ange en ny resurs som kommer från en resursfil. Resursfilen ska innehålla en post för resursen med namnet "GoButton.Content". Innehållet i det här fallet är en specifik egenskap som ärvs av klassen Button . Du kan också ange lokaliserade värden för andra egenskaper för den här knappen, till exempel kan du ange ett resursbaserat värde för "GoButton.FlowDirection". Mer information om hur du använder x:Uid och resursfiler tillsammans finns i Lokalisera strängar i ditt gränssnitt och apppaketmanifest.

Giltigheten för vilka strängar som kan användas för ett x:Uid-värde styrs i praktisk mening genom vilka strängar är lagliga som identifierare i en resursfil och en resurssökväg.

x:Uid är diskret från x:Name både på grund av det angivna XAML-lokaliseringsscenariot och så att identifierare som används för lokalisering inte har några beroenden av programmeringsmodellens konsekvenser av x:Name. Dessutom styrs x:Name av begreppet XAML-namnscope, medan unikhet för x:Uid styrs av PRI-systemet (Package Resource Index). Mer information finns i Hantera resurser med MRT Core och Resource Management System.

Windows Runtime XAML har något annorlunda regler för x:Uid-unikhet än tidigare XAML-användningstekniker som används. För Windows Runtime XAML är det lagligt att samma x:Uid-ID-värde finns som ett direktiv för flera XAML-element. Varje sådant element måste dock sedan dela samma lösningslogik när du löser resurserna i en resursfil. Dessutom delar alla XAML-filer i ett projekt ett enda resursomfång för x:Uid-upplösning , det finns inget begrepp om x:Uid-omfång som justeras till enskilda XAML-filer.

I vissa fall använder du en resurssökväg i stället för inbyggda funktioner i PRI-systemet (Package Resource Index). Alla strängar som används som ett x:Uid-värde definierar en resurssökväg som börjar med ms-resource:///Resources/ och innehåller x:Uid-strängen . Sökvägen kompletteras med namnen på de egenskaper som du anger i en resursfil eller på annat sätt riktar in dig på.

Placera inte x:Uid på egenskapselement som inte är tillåtna i Windows Runtime XAML.