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 języka XAML

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

Wartości XAML

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

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 dyskretny zarówno ze x:Name względu na określony scenariusz lokalizacji XAML, jak i dlatego identyfikatory używane do lokalizacji nie mają zależności od wpływu x:Namemodelu programowania na . x:Name Ponadto program podlega zakresowi nazw XAML, x:Uid jednak nie podlega żadnemu zdefiniowanemu językowi XAML koncepcji wymuszania unikatowości. Procesory XAML w szerokim sensie (procesory, które nie są częścią procesu lokalizacji) nie powinny wymuszać unikatowości x:Uid wartości. Ta odpowiedzialność jest koncepcyjnie zależna od inicjatora wartości. Oczekiwanie na unikatowość x:Uid wartości 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ą lokalializacji, a nie we wszystkich przypadkach, w których w adiustacji napotkana jest wartość ciągu tekstowego.

Struktury mogą określać konkretną właściwość w modelu obiektów jako alias, 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 element członkowski aliasu, jak i na tym samym obiekcie. Jeśli określono oba x:Uid elementy członkowskie i alias, interfejs API usług XAML platformy XamlDuplicateMemberException .NET zwykle zgłasza ten przypadek.

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 XAML, zobacz Globalizacja dla WPF lub Uid

Zobacz też