x:Uid 指示詞

為標記元素提供唯一識別符。 對於通用 Windows 平台 (UWP) XAML，此唯一識別碼由 XAML 在地化程序和工具使用，例如使用 .resw 資源檔案中的資源。

XAML 屬性用法

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

XAML 值

詞彙	描述
stringID	唯一標識應用程式中 XAML 元素的字串，並成為資源檔案中資源路徑的一部分。 請參閱＜備註＞。

備註

使用 x:Uid 來識別 XAML 中的物件元素。 通常，此物件元素是控制項類別的執行個體或 UI 中顯示的其他元素。 x:Uid 中使用的字串與資源檔案中使用的字串之間的關係是，資源檔案字串是 x:Uid 後面接著一個點 (.)，然後是該元素的特定屬性的名稱正在本地化。 請考慮此範例：

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

若要指定內容來取代顯示文字 Go，您必須指定來自資源檔案的新資源。 您的資源文件應該包含名為 「GoButton.Content」 的資源專案。 本例中的內容是由 Button 類別繼承的特定屬性。 您也可以為此按鈕的其他屬性提供本地化值，例如，您可以為「GoButton.FlowDirection」提供基於資源的值。 有關如何一起使用 x:Uid 和資源文件的詳細資訊，請參閱本地化 UI 和應用程式套件清單中的字串。

哪些字串可用於 x:Uid 值的有效性在實際意義上由哪些字串作為資源檔案和資源路徑中的識別符合法來控制。

x:Uid 與 x:Name 是離散的，這既是因為所規定的 XAML 本地化方案，也是因為用於本地化的標識符不依賴 x:Name 的程式模型含義。 此外，x:Name 由 XAML 名稱範圍概念控制，而 x:Uid 的唯一性由套件資源索引 (PRI) 系統控制。 有關詳細資訊，資源管理系統。

UWP XAML 對於 x:Uid 唯一性的規則與先前使用的 XAML 利用技術有所不同。 對於 UWP XAML，相同的 x:Uid ID 值作為指令存在於多個 XAML 元素上是合法的。 不過，在解析資源檔中的資源時，每個這類專案都必須共用相同的解析邏輯。 此外，專案中的所有 XAML 檔案出於 x:Uid 解析目的共享單一資源範圍，不存在將 x:Uid 範圍與各個 XAML 檔案對齊的概念。

在某些情況下，您將使用資源路徑而不是套件資源索引 (PRI) 系統的內建功能。 任何用作 x:Uid 值的字串都定義以 ms-resource:///Resources/ 開頭並包含 x:Uid 字串的資源路徑。 此路徑由您在資源檔案中指定或以其他方式定位的屬性的名稱完成。

不要將 x:Uid 放在屬性元素上，這在 Windows 執行階段 XAML 中是不允許的。