x:Key 指示詞
在 XAML 定義的字典中建立和參考的唯一識別項目。
XAML 屬性使用方式
<object x:Key="stringKeyValue".../>
-or-
<object x:Key="{markupExtensionUsage}".../>
XAML 屬性使用方式 (特定於 WPF)
<object.Resources>
<object x:Key="stringKeyValue".../>
</object.Resources>
-or-
<object.Resources>
<object x:Key="{markupExtensionUsage}".../>
</object.Resources>
XAML 值
stringKeyValue |
文字字串，使用做為索引鍵。 文字字串必須符合 XamlName 文法。 |
markupExtensionUsage |
在標記延伸分隔符號 {} 內部，提供物件以用來做為索引鍵的標記延伸使用方式。 請參閱「備註」。 |
備註
在 XAML 2006 和 WPF 中，必須提供 x:Key 做為屬性。 您依然可以使用非字串索引鍵，但這需要標記延伸使用方式，才能在屬性表單中提供非字串值。 如果使用的是 XAML 2009，則可以將 x:Key 指定為項目，以明確支援依非字串的物件型別索引的字典，而不需要標記延伸中繼。 請參閱本主題中的＜XAML 2009＞一節。 「備註」區段的其餘部分專門適用於 XAML 2006 實作。
x:Key 的屬性值可以是 XamlName 文法中定義的任何字串，也可以是透過標記延伸評估的物件。 如需 WPF 的範例，請參閱＜WPF 使用方式附註＞。
本身為 IDictionary 實作的父項目，其子項目通常必須包含 x:Key 屬性，以指定該字典內的唯一索引鍵值。 架構可能會實作別名索引鍵屬性以取代特定型別上的 x:Key。定義這類屬性的型別都應該以 DictionaryKeyPropertyAttribute 屬性化。
指定 x:Key 的相同程式碼，也就是用於基礎 IDictionary 的索引鍵。 例如，套用在 WPF 內資源之標記中的 x:Key，就等同於在程式碼中將資源加入至 WPF ResourceDictionary 時，ResourceDictionary.Add 的 key 參數值。
WPF 使用注意事項
做為父物件的子物件，如果是 IDictionary 實作，像是 WPF ResourceDictionary，通常必須包含 x:Key 屬性，而且索引鍵值在字典內必須是唯一的。 有兩個值得注意的例外狀況：
一些 WPF 型別宣告字典使用方式的隱含索引鍵。 例如，具有 TargetType 的 Style，或是具有 DataType 的 DataTemplate，都可位在 ResourceDictionary 中，並使用隱含機碼。
WPF 支援合併的資源字典概念。 索引鍵可以在合併的字典之間共用，而且可以使用 FindResource 來存取共用的索引鍵行為。 如需詳細資訊，請參閱合併的資源字典。
在整體 WPF XAML 實作和應用程式模型中，XAML 標記編譯器不會檢查索引鍵唯一性。 反之，缺少或非唯一x:Key值會導致載入時間 XAML 剖析器錯誤。 然而，Visual Studio 處理 WPF 字典往往會在設計階段注意到這樣的錯誤。
請注意，在以下語法中，在 WPF XAML 處理器產生集合以填入 Resources 集合的過程中，ResourceDictionary 物件是隱含的。 ResourceDictionary 通常不會在標記中明確提供為項目，雖然在某些情況下，可以於必要時提供以避免困擾 (它會是 Resources 屬性項目與其內部填入字典的項目之間的集合物件項目)。 如需集合物件在標記中幾乎必定為隱含項目之原因的詳細資訊，請參閱 XAML 語法詳細資料。
在 WPF XAML 的實作中，資源字典索引鍵的處理是由 ResourceKey 抽象類別所定義。 不過，WPF XAML 處理器會根據索引鍵的使用方式，產生不同的基礎擴充類型。 例如，DataTemplate 或任何衍生類別的索引鍵都是分開處理的，並會產生不同的 DataTemplateKey 物件。
索引鍵和名稱使用基本 XAML 定義中的不同指示詞和語言項目 ( x:Key 與 x:Name 的比較)。 索引鍵和名稱也會在不同的情況下，由 WPF 定義和這些概念的應用程式所使用。 如需詳細資訊，請參閱 WPF XAML 名稱範圍。
如先前所述，機碼的值可以透過標記延伸提供，並成為字串值以外的值。 例如，x:Key 值可能為 ComponentResourceKey，即是一種 WPF 情節。 某些控制項會針對影響控制項之外觀及行為部分，而不取代樣式的自訂樣式資源，公開該型別的樣式索引鍵。 這類索引鍵的範例有 ButtonStyleKey。
WPF 合併字典功能對於索引鍵唯一性和索引鍵查閱行為，引入了額外的考量。 如需詳細資訊，請參閱合併的資源字典。
XAML 2009
XAML 2009 放寬了 x:Key 必須以屬性形式提供的限制。
在 WPF 中，您可以使用 XAML 2009 功能，但是只能針對未進行標記編譯的 XAML。 WPF 的標記編譯 XAML 以及 XAML 的 BAML 表單目前不支援 XAML 2009 關鍵字和功能。
在 XAML 2009 之下，您可以透過下列使用方式指定 x:Key 項目：
XAML 項目使用方式 (僅適用於 XAML 2009)
<object>
<x:Key>
keyObject
</x:Key>
...
</object>
XAML 值
keyObject |
在特殊字典中做為指定 object 的索引鍵之物件的物件項目。 |
這裡不會顯示這種用途的容器/父代。 object 必須是某個表示特製化字典實作之物件項目的子代。 keyObject 應該是物件執行個體 (或實值型別的值)，而且適當做為該特定特殊字典實作的索引鍵。
WPF 不會實作需要這種使用方式的字典。 物件索引鍵是更廣泛的 XAML 語言功能，可能適用於需要在 XAML 中建立字典的某些自訂字典案例。 若為 WPF 功能 (例如使用資源非字串索引鍵的隱含樣式)，會有其他建立或指定索引鍵的技術存在，因此不需使用物件索引鍵。
keyObject 也可能是物件項目格式的標記延伸使用方式，而不是直接物件執行個體。
Silverlight 使用方式備註
Silverlight 的 x:Key 會在其他篇幅中做說明。 如需詳細資訊，請參閱XAML 命名空間 (x:) 語言功能 (Silverlight)。