dyrektywa x:Uid

Określa unikatowy identyfikator elementów znacznika. W przypadku języka XAML platformy uniwersalnej systemu Windows (UWP) ten unikatowy identyfikator jest używany przez procesy lokalizacji i narzędzia XAML, takie jak używanie zasobów z pliku zasobów resw.

Użycie atrybutu XAML

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

Wartości XAML

Termin	Description
stringID	Ciąg, który jednoznacznie identyfikuje element XAML w aplikacji i staje się częścią ścieżki zasobu w pliku zasobu. Zobacz uwagi.

Uwagi

Użyj identyfikatora x:Uid , aby zidentyfikować element obiektu w języku XAML. Zazwyczaj ten element obiektu jest wystąpieniem klasy kontrolnej lub innego elementu, który jest wyświetlany w interfejsie użytkownika. Relacja między ciągiem używanym w x:Uid i ciągami używanymi w pliku zasobów polega na tym, że ciągi plików zasobów to x:Uid , po którym następuje kropka (.), a następnie nazwa określonej właściwości elementu, który jest zlokalizowany. Rozważmy następujący przykład:

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

Aby określić zawartość, która ma zastąpić tekst wyświetlany, należy określić nowy zasób pochodzący z pliku zasobu. Plik zasobu powinien zawierać wpis zasobu o nazwie "GoButton.Content". Zawartość w tym przypadku to określona właściwość dziedziczona przez klasę Button . Możesz również podać zlokalizowane wartości dla innych właściwości tego przycisku, na przykład można podać wartość opartą na zasobach dla elementu "GoButton.FlowDirection". Aby uzyskać więcej informacji na temat używania elementu x:Uid i plików zasobów razem, zobacz Lokalizację ciągów w interfejsie użytkownika i manifeście pakietu aplikacji.

Ważność ciągów, których można używać dla wartości x:Uid , jest kontrolowana w praktycznym sensie, dzięki czemu ciągi są legalne jako identyfikator w pliku zasobu i ścieżki zasobu.

x:Uid jest dyskretny 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 koncepcji zakresu nazw XAML, natomiast unikatowość x :Uid jest kontrolowana przez system indeksu zasobów pakietu (PRI). Aby uzyskać więcej informacji, zobacz Zarządzanie zasobami za pomocą rozwiązania MRT Core i systemu zarządzania zasobami.

Język XAML środowiska uruchomieniowego systemu Windows ma nieco inne reguły dotyczące unikatowości x:Uid niż poprzednie używane technologie wykorzystujące język XAML. W przypadku środowiska uruchomieniowego okna XAML jest to legalne, aby ta sama wartość identyfikatora x:Uid istniała jako dyrektywa dla wielu elementów XAML. Jednak każdy taki element musi następnie współdzielić tę samą logikę rozwiązywania podczas rozpoznawania zasobów w pliku zasobów. Ponadto wszystkie pliki XAML w projekcie mają jeden zakres zasobów do celów rozpoznawania x:Uid, nie ma pojęcia x:Uid przypisanych do poszczególnych plików XAML.

W niektórych przypadkach będziesz używać ścieżki zasobów, a nie wbudowanej funkcji systemu indeksu zasobów pakietu (PRI). Dowolny ciąg używany jako wartość x:Uid definiuje ścieżkę zasobu rozpoczynającą się od ms-resource:///Resources/ i zawiera ciąg x:Uid . Ścieżka jest uzupełniana przez nazwy właściwości, które określisz w pliku zasobów lub które są w inny sposób kierowane.

Nie umieszczaj x:Uid na elementach właściwości, ponieważ nie jest to dozwolone w środowisku Windows Runtime XAML.