共用方式為


StaticResource 標記延伸

更新:2007 年 11 月

透過查閱已定義資源的參考,提供任何 XAML 屬性 (Property) 屬性 (Attribute) 的值。這種資源的查閱行為與載入時間的查閱類似,它會尋找先前從目前 XAML 頁面之標記以及其他應用程式來源載入的資源,並產生該資源值,做為執行階段物件中的屬性值。

XAML 屬性使用方式

<object property="{StaticResource key}" .../>

XAML 物件項目使用方式

<object>
  <object.property>
<StaticResource ResourceKey="key" .../>
  </object.property>
</object>

XAML 值

key

要求之資源的索引鍵。這個索引鍵一開始是由 x:Key 屬性指派 (如果在標記中建立資源),或是在呼叫 ResourceDictionary.Add 時提供以做為 key 參數 (如果在程式碼中建立資源)。

備註

重要事項:

如果資源已用詞彙形式在 XAML 檔案內進一步定義,StaticResource 就不能嘗試建立該資源的向前參考 (Forward Reference)。這種嘗試不受支援,而且即使這類參考並未失敗,在搜尋代表 ResourceDictionary 的內部雜湊表時,嘗試進行向前參考也會對載入時間 (Load Time) 效能產生負面影響。為了達到最佳結果,請調整資源字典的組合,以避免進行向前參考。如果無法避免向前參考,請改用 DynamicResource 標記延伸

指定的 ResourceKey 應該對應於 x:Key 屬性在頁面、應用程式、可用控制項佈景主題和外部資源的某個層級上定義的現有資源,或是對應於系統資源。資源查閱將會按照該順序來執行。如需靜態 (Static) 和動態 (Dynamic) 資源之資源查閱行為的詳細資訊,請參閱資源概觀

資源索引鍵可以是 XamlName 文法中定義的任何字串。資源索引鍵也可以是其他物件型別,例如 TypeType 索引鍵是透過隱含樣式索引鍵,依佈景主題設定控制項樣式的基礎。如需詳細資訊,請參閱控制項撰寫概觀

另一種參考資源的宣告方式是 DynamicResource 標記延伸

屬性 (Attribute) 語法是最常配合這個標記延伸使用的語法。StaticResource 識別項字串後提供的字串語彙基元,是指派做為基礎 StaticResourceExtension 延伸類別的 ResourceKey 值。

StaticResource 可用於物件項目語法。在這種情況下,您必須指定 ResourceKey 屬性的值。

StaticResource 也可用於將 ResourceKey 屬性 (Property) 指定為 property=value 配對的詳細屬性 (Attribute) 使用方式。

<object property="{StaticResource ResourceKey=key}" .../>

繁複的使用方法所適用的擴充,通常是具有一個以上可設定屬性或有些屬性為選擇性。因為 StaticResource 只有一個必要的可設定屬性,所以這種詳細使用方式並不常見。

在 WPFXAML 處理器實作 (Implementation) 中,這個標記延伸的處理是由 TypeExtension 類別所定義。

StaticResource 是一種標記延伸。如果必須將屬性 (Attribute) 值加上逸出符號,以免成為常值或處理常式名稱,而且這個動作必須更全面地實施 (而不是只對特定型別或屬性 (Property) 設定型別轉換子 (Type Converter)),則通常會實作標記延伸。XAML 所有的標記延伸都會在屬性 (Attribute) 語法中使用 { 和 } 字元,透過這個慣例,XAML 處理器會辨認出標記延伸必須處理該屬性 (Attribute)。如需詳細資訊,請參閱標記延伸和 XAML

請參閱

概念

設定樣式和範本

XAML 概觀

標記延伸和 XAML

資源概觀

資源和程式碼