Sdílet prostřednictvím

x:Uid – direktiva

  • Článek

Poskytuje jedinečný identifikátor prvků značek. V mnoha scénářích používá tento jedinečný identifikátor lokalizační procesy a nástroje XAML.

Použití atributu XAML

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

Hodnoty XAML

Hodnota Popis
identifier Ručně vytvořený nebo automaticky vygenerovaný řetězec, který by měl být jedinečný v souboru, když je interpretován uživatelem x:Uid.

Poznámky

V [MS-XAML], x:Uid je definován jako direktiva. Další informace naleznete v [MS-XAML] Oddíl 7.3.6.

x:Uid je diskrétní od x:Name jak kvůli popsanému scénáři lokalizace XAML, tak kvůli tomu, že identifikátory používané pro lokalizaci nemají žádné závislosti na dopadu programovacího modelu x:Name. x:Name se řídí také názvem XAML; x:Uid se ale neřídí žádným jazykem XAML definovaným konceptem vynucování jedinečnosti. U procesorů XAML v širokém smyslu (procesory, které nejsou součástí procesu lokalizace), se neočekává, že budou vynucovat jedinečnost x:Uid hodnot. Tato odpovědnost je koncepčně na původci hodnot. Očekávání jedinečnosti x:Uid hodnot v rámci jednoho zdroje XAML je přiměřené pro uživatele hodnot, jako jsou vyhrazené procesy globalizace nebo nástroje. Typický model jedinečnosti spočívá v tom, že x:Uid hodnoty jsou jedinečné v souboru s kódováním XML, který představuje XAML.

Nástroje, které mají významné znalosti o konkrétním schématu XAML, se můžou rozhodnout použít x:Uid pouze pro skutečné lokalizovatelné řetězce, a ne pro všechny případy, kdy je v kódu zjištěna hodnota textového řetězce.

Architektury mohou v objektovém modelu určit konkrétní vlastnost, která má být aliasem pro x:Uid použitím atributu UidPropertyAttribute na definující typ. Pokud architektura určuje konkrétní vlastnost, není platné zadat x:Uid i aliasovaný člen na stejném objektu. Pokud jsou zadány x:Uid i člen aliasu, rozhraní API služby .NET XAML obvykle vyvolá XamlDuplicateMemberException pro tento případ.

Poznámky k využití WPF

Další informace o roli x:Uid v procesu lokalizace WPF a ve formě BAML XAML naleznete v tématu Globalizace pro WPF nebo Uid

Viz také