Control.DefaultStyleKey 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得或設定參考控件預設樣式的索引鍵。 自定義控件的作者會使用此屬性來變更其控件所使用的樣式預設值。
protected:
property Platform::Object ^ DefaultStyleKey { Platform::Object ^ get(); void set(Platform::Object ^ value); };IInspectable DefaultStyleKey();
void DefaultStyleKey(IInspectable value);protected object DefaultStyleKey { get; set; }Protected Property DefaultStyleKey As Object屬性值
參考控制件預設樣式的索引鍵。 若要在主題樣式查閱中正確運作，此值必須是 System.Type 值。
注意
(C++/CX) Visual C++ 元件延伸模組會使用類型限定名稱的字串。 但這取決於產生的程序代碼，此程式代碼會在 XAML 編譯程式存取之後產生 TypeName ;請參閱。
備註
DefaultStyleKey 是 Windows 執行階段 API 中少數受保護的屬性之一。 它僅供控件作者使用，這些作者將子類別化某些現有的控件類別，因此必須有設定此屬性的必要存取權。 對於您將設定 DefaultStyleKey 的許多自定義控件案例，您也會覆寫 OnApplyTemplate。
DefaultStyleKey 的傳回型別在語法中會鬆散類型為 Object ，但 XAML 樣式系統會預期值會提供類型參考：
- 對於以 C# 撰寫其邏輯的控件，DefaultStyleKey 的值應該是 System.Type 的實例。 您通常會在預設建構函式中設定此值：
public CustomControl1()
{
this.DefaultStyleKey = typeof(CustomControl1);
}
CustomControl1::CustomControl1() // public: in the header.
{
DefaultStyleKey(winrt::box_value(L"App1.CustomControl1"));
}
- 對於以 Visual C++ 元件延伸模組撰寫的控件， (C++/CX) ，DefaultStyleKey 的值應該是自定義控件類別名稱的命名空間限定字元串。 您通常會在預設建構函式中設定此值：
CustomControl1::CustomControl1() //public: in the header
{
DefaultStyleKey = "App1.CustomControl1";
}
注意
最後，字串不足以支援 Visual C++ 元件延伸模組， (C++/CX) 類型參考。 如果您在 方案總管 中使用 [新增/新增專案/樣板化控件] 選項，Visual C++ 元件延伸模組的範本和支援 (C++/CX) ，XAML 會產生提供 IXamlMetadataProvider 資訊的類別。 XAML 編譯程式可以在載入 XAML 時存取此程式代碼，並使用它來驗證和建立類型和成員，並聯結部分類別。 就您在自己的應用程式程式代碼中定義的內容而言，您只需要字串。 但如果您想要瞭解，您可以查看產生的 XamlTypeInfo.g.h 和XamlTypeInfo.g.cpp檔案。
控件作者可以選擇不提供DefaultStyleKey的值，但這並不常見。 結果是預設樣式是基類所定義的樣式。 在某些情況下， (ContentControl) 值為 null。 即使您選擇不要重新定義值，也請確定原始的默認樣式對於轉譯控件很有用。
載入 XAML 控制件時，轉譯程式會啟動，而且系統正在尋找要套用的正確範本，載入的內容是控制元件的 XAML 預設樣式，包括其範本。 包含在 Windows 執行階段 是 Windows 執行階段 定義之所有 XAML 控制件之所有預設樣式的內部複本。 DefaultStyleKey 中的類型參考會告知系統要載入的 XAML 資源作為此樣式。 在 XAML 表單中，樣式實際上是以類型為索引鍵，即使 Windows 執行階段 XAML 中沒有明確定義類型參考的機制也一樣。 但是，對於任何 TargetType 值而言，這是保存查閱索引鍵的屬性，它會隱含地假設以字串形式表示類型參考。 例如， Button 的 DefaultStyleKey 是 System.Type 實例， 其中 Name 是 “Button”， FullName 是 “Windows.UI.Xaml.Controls.Button”。 系統會使用這項資訊，從具有TargetType="Button"的內部資源載入 Style。
自定義控制項通常不在預設 XAML 命名空間中。 相反地，它們位於具有 using： 語句的 XAML 命名空間中，用來參考應用程式的程式代碼命名空間。 根據預設，專案會建立前置詞 「local：“，為您對應此命名空間。 您也可以對應其他 XAML 命名空間，以參考控制件的其他程式碼命名空間，或應用程式所定義的其他程式代碼。
“local：” 前置詞 (或對應至您應用程式程式代碼和命名空間的其他命名空間，) 在 XAML 中做為 TargetType 值時，應該在自定義控件的名稱前面。 這也會由起始範本為您完成;當您新增控件時，您會看到只包含一個樣式的 generic.xaml 檔案。 該樣式會有 TargetType 值，其字串開頭為 “local：”，並以您為自定義控件類別選擇的名稱來完成。 若要比對先前在定義中 CustomControl1 設定 DefaultStyleKey 的範例，您會看到元素定義 <Style TargetType="local:CustomControl1"> 於起始 generic.xaml 中，而且該樣式會定義控件範本，以及設定其他屬性。
注意
“local：” 前置詞會隔離至其定義及使用所在的 XAML。 XAML 命名空間和前置詞在 XAML 中只有意義，而且每個 XAML 檔案都是獨立的。 程序代碼中的 DefaultStyleKey 值不包含前置詞。