Udostępnij za pośrednictwem

x:Uid, dyrektywa

  • Artykuł

Udostępnia unikatowy identyfikator elementów znaczników. W wielu scenariuszach ten unikatowy identyfikator jest używany przez procesy i narzędzia lokalizacji XAML.

Użycie atrybutu XAML

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

Wartości XAML

Wartość Opis
identifier Ręcznie utworzony lub wygenerowany automatycznie ciąg, który powinien być unikatowy w pliku, gdy jest interpretowany przez użytkownika x:Uid.

Uwagi

W pliku [MS-XAML] x:Uid jest definiowana jako dyrektywa. Aby uzyskać więcej informacji, zobacz [MS-XAML] Sekcja 7.3.6.

x:Uid jest odrębny od x:Name zarówno ze względu na określony scenariusz lokalizacji XAML, jak i tak, że identyfikatory używane do lokalizacji nie mają zależności od wpływu modelu programowania x:Name. Ponadto x:Name podlega zakresowi nazw XAML; jednak x:Uid nie podlega żadnej zdefiniowanej koncepcji wymuszania unikatowości języka XAML. Procesory XAML w szerokim sensie (procesory, które nie są częścią procesu lokalizacji) nie powinny wymuszać unikatowości wartości x:Uid. Ta odpowiedzialność jest koncepcyjnie zależna od inicjatora wartości. Oczekiwanie na unikatowość wartości x:Uid w jednym źródle XAML jest uzasadnione dla konsumentów wartości, takich jak dedykowane procesy globalizacji lub narzędzia. Typowy model unikatowości polega na tym, że x:Uid wartości są unikatowe w pliku zakodowanym w formacie XML, który reprezentuje kod XAML.

Narzędzia, które mają znaczącą wiedzę na temat określonego schematu XAML, mogą zdecydować się na zastosowanie x:Uid tylko dla ciągów z możliwością lokalizowania, a nie we wszystkich przypadkach, w których w adiustacji napotkano wartość ciągu tekstowego.

Struktury mogą określać konkretną właściwość w modelu obiektów jako alias dla x:Uid, stosując atrybut UidPropertyAttribute do typu definiującego. Jeśli struktura określa konkretną właściwość, nie jest prawidłowa, aby określić zarówno x:Uid, jak i aliasowany element członkowski na tym samym obiekcie. Jeśli określono zarówno x:Uid, jak i aliasowany element członkowski, interfejs API usług XAML platformy .NET zwykle zgłasza XamlDuplicateMemberException dla tego przypadku.

Uwagi dotyczące użycia platformy WPF

Aby uzyskać więcej informacji na temat roli x:Uid w procesie lokalizacji WPF i w postaci BAML języka XAML, zobacz globalizacji dla WPF lub Uid

Zobacz też