x:Uid – direktiva

Poskytuje jedinečný identifikátor prvků značek. Pro WinUI XAML je tento jedinečný identifikátor použit lokalizačními procesy a nástroji pro XAML, například při využití prostředků ze souboru prostředků .resw.

Použití atributu XAML

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

Hodnoty XAML

Term	Description
stringID	Řetězec, který jednoznačně identifikuje prvek XAML v aplikaci a stává se součástí cesty ke zdroji v souboru prostředků. Viz poznámky.

Poznámky

K identifikaci elementu objektu v XAML použijte x:Uid . Tento element objektu je obvykle instance třídy ovládacího prvku nebo jiného prvku, který je zobrazen v uživatelském rozhraní. Vztah mezi řetězcem, který používáte v x:Uid , a řetězci, které používáte v souboru prostředků, je, že řetězce souboru prostředků jsou x:Uid následované tečkou (.) a pak názvem konkrétní vlastnosti elementu, který se lokalizuje. Podívejte se na tento příklad:

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

Chcete-li zadat obsah, který má nahradit zobrazovaný text Go, je nutné zadat nový prostředek, který pochází ze souboru prostředků. Soubor prostředku by měl obsahovat položku pro prostředek s názvem "GoButton.Content". Obsah v tomto případě je specifická vlastnost, která je zděděna třídou Button . Můžete také zadat lokalizované hodnoty pro další vlastnosti tohoto tlačítka, například můžete zadat hodnotu založenou na prostředcích pro GoButton.FlowDirection. Další informace o tom, jak společně používat x:Uid a soubory prostředků, najdete v tématu Lokalizace řetězců v manifestu uživatelského rozhraní a balíčku aplikace.

Platnost řetězců, které lze použít pro hodnotu x:Uid , je řízena praktickým smyslem, pomocí kterého řetězce jsou legální jako identifikátor v souboru prostředků a cestě k prostředku.

x:Uid je diskrétní z x:Name jak kvůli zadanému scénáři lokalizace XAML, tak kvůli tomu, že identifikátory, které se používají pro lokalizaci, nemají žádné závislosti na dopadu programovacího modelu na x:Name. Také je x:Name řízen konceptem XAML "namescope", zatímco jedinečnost x:Uid je řízena systémem indexu prostředků balíčku (PRI). Další informace najdete v tématu Správa prostředků pomocí jádra MRT a systému správy prostředků.

Xaml modulu prostředí Windows Runtime má poněkud jiná pravidla jedinečnosti x:Uid než předchozí použité technologie využívající XAML. V případě modulu Windows Runtime XAML je legální, aby stejná hodnota ID x:Uid existovala jako direktiva pro více elementů XAML. Každý takový prvek však musí při řešení prostředků v souboru prostředků sdílet stejnou logiku řešení. Všechny soubory XAML v projektu také sdílejí jeden rozsah prostředků pro účely rozlišení x:Uid. Neexistuje žádný koncept toho, že by obory x:Uid byly sladěny s jednotlivými soubory XAML.

V některých případech budete místo předdefinovaných funkcí systému indexu prostředků balíčku (PRI) používat cestu k prostředkům. Jakýkoli řetězec použitý jako hodnota x:Uid definuje cestu k prostředku, který začíná na ms-resource:///Resources/ a zahrnuje řetězec x:Uid. Cesta je dokončena pomocí názvů vlastností, které zadáte v souboru prostředků, nebo na které se jinak zaměřujete.

Neukládejte x:Uid na elementy vlastností, které nejsou povoleny v xaml prostředí prostředí Windows Runtime.