如何使用資源文件
摘要
.NET 中有一套非常完善的地方化系統被定義在 System.Resources 名字空間中。不過大多數人都被 MissingManifestResourceException 這個錯誤困惑着。本文就是要讓大家瞭解什麼是資源文件，它有什麼用處以及如何正確的調用從而避免一些"奇怪"的錯誤，包括 MissingManifestResourceException 這個常見錯誤。
目錄
本文來源以及最終目的
什麼是資源文件
資源文件類型
調用資源文件的幾種方法
如何準確的定義資源文件的邏輯位置
推薦工具
總結
參考信息
關於作者
本文來源以及最終目的
最近作者在新聞組中看到許多有關資源文件的問題，而大多數人都有 MissingManifestResourceException 這個非常時髦的錯誤。所以作者考慮了一下，決定不想再讓更多的人把時間都浪費在這個問題上了。這就是這篇文章的誕生原因。而最終目的除了讓這個問題在新聞組上消失之外還要讓大家在 10 分鐘內徹底掌握資源的調用，從而成爲真正的資源高手！：）
什麼是資源文件
在 .NET 中準備 World-Ready 程序時需要三步，Globalization，Localizability 和 Localization。在這第三步的 Localization 中就是使用資源文件最常見的地方。（本文不討論 World-Ready 程序，或許以後在另一篇文章中）因爲程序的邏輯界面需要與資源界面隔離，而資源界面就是我們所說的資源文件。顧名思義，一個資源文件中當然全是資源，不過，什麼是資源？這裏所謂的資源就是程序中可利用的數據，譬如：字符串、圖片和任何二進制數據，包括任何類型的文件。注意一個資源文件可以有多種語言版本，舉例，一個 Strings.resources 文件可以有英語版、簡體中文版、繁體中文版等。 ResourceManager 可以自動根據文件名來確認調用哪個版本。不同的版本只要在文件名中添入區域語言就可以了。比如，我們的 Strings.resources 是默認版，英語版的可以是 Strings.en-US.resources（美國英文），簡體中文的可以是 Strings.zh-CHS.resources（簡體中文），而繁體中文的就可以是 Strings.zh-CHT.resources（繁體中文）。所謂的默認版就是當找不到適當的資源版本時用的資源，一般都是英文。默認文件應當被嵌入到主 Assembly 中，這樣就不會發生找不到資源的錯誤。在 VS.NET 中將一個文件的屬性設爲 Embedded Resource 可以使資源被嵌入到主 Assembly 中。
資源文件類型
System.Resources 名字空間支持三種資源文件：
.txt 文件，只能有字符串資源。因爲不能被嵌入到 Assembly 中，所以很容易暴露，被客戶修改。最大缺點是僅支持字符串資源，所以不推薦使用。
.resx 文件，由 XML 組成，可以加入任何資源，包括二進制。同樣不能被嵌入到 Assembly 中。在 System.Resources 名字空間中有專用讀寫的類。VS.NET 創建這種文件然後將其轉成 .resources 文件並根據設置將其嵌入到 Assembly 中。
.resources 文件，PE 格式，可以加入任何資源。唯一可以被嵌入到 Assembly 的文件，在 System.Resources 名字空間中有專用讀寫的類。
調用資源文件的幾種方法
ResourceManager 可以根據不同的 UICulture 設置返回不同的本地資源（這與 World-Ready 程序有關，在此不討論），我們只需知道調用資源用到它就可以了。接下來讓我們看看如何調用每一種：
.txt 文件：
不可以直接調用，得先將其轉換成 .resources 文件才能使用。（關於如何轉換請看"推薦工具"）
.resx 文件：
可以用 ResXResourceReader 來做讀取，但是這種方法不直觀，不推薦直接調用 .resx 文件。正確的方法是將其轉換成 .resources 文件，然後用 ResourceManager 作讀取工作。注意如果是在 VS.NET 中添加的 .resx 文件，那麼它們自動被設爲 Embedded Resource，轉成 .resources 文件後被嵌入到 Assembly 中。
.resources 文件：
分成兩種情況：
被嵌入或編譯成 Satellite Assembly：
用 ResourceManager 的各種 constructor 來獲得在 Assembly 中的資源。
單獨文件，沒被編譯或嵌入到 Assembly 中：
可以用 ResourceManager.CreateFileBasedResourceManager 來獲得資源集（ResourceSet），就是所有的資源。
特殊情況：
還有一種特殊情況，那就是當你直接嵌入一資源時，也就是說，不通過一個資源文件而直接將一資源嵌入到 Assembly 中。這可以在 VS.NET 中通過設置一文件的 Build 屬性爲 Embedded Resource 實現。在這種情況下 ResourceManager 就沒有用了，因爲它只能獲取 .resources 資源文件（在或不在 Assembly 中）。那麼如何調用這類的資源呢？不難，我們需要利用一些 Reflection 中的特徵。別怕，不是讓你再學 Reflection，其實我們只要瞭解一些 System.Reflection.Assembly 這個類中的一些函數就可以了。有三個相關函數，不過我們只需要 Assembly.GetManifestResourceStream 這個函數。這個函數將一嵌入到 Assembly 中的資源以 stream 的方式返回，而我們可以將這個 stream 轉成在 .NET 中可用的對象。比如，如果嵌入資源是一圖片，那麼我們可以利用 New Bitmap(Stream) 這個 Bitmap 的 constructor 獲得這個圖片資源的 Bitmap 對象。
注：在這裏僅介紹怎樣獲得不同的資源的方法，關於怎樣用各個類與函數請參看有關文檔。
如何準確的定義資源文件的邏輯位置
我想這是許多人最關注的一段了！在這裏作者將解說如何正確的填寫 ResouceManager(String, Assembly) 這個 constructor，還有如何正確的填寫 Assembly.GetManifestResourceStream(String)，因爲它們兩個的原理是相同的。看過了上面的描述，到了這裏就簡單多了。這裏主要討論的是怎麼填寫那個 String。這個 String 就是資源的完整名，一個完整名由它的名字空間和文件名前部分（BaseName）組成。例如，如果默認名字空間（root namespace）是 DefaultNamespace，資源文件的名字是 Strings.en-US.resources，那麼它的完整名就是 DefaultNamespace.Strings。這個很簡單，不過怎樣確定名字空間呢？這就有些奇怪了，因爲 C# 的編譯器與 VB.NET 的編譯器有些不同。作者在這裏分別給出兩個編譯器怎樣給嵌入資源自動添加命名空間：
C#
它自動添加 default namespace（與 root namespace 相同），但也添加子文件夾的名字。例如，在 Subfolder 子文件夾下放的資源文件 Strings.en-US.resources，它的完整名是 default namespace + subfolder + base name = DefaultNamespace.Subfolder.Strings
VB.NET
在 VB.NET 中就很簡單了，它自動給嵌入資源添加 root namespace。不管你在哪個子文件夾中放置資源文件，資源文件的完整名永遠是 root namespace + base name。
根據上面的描述，如果我們使用 C#，用 VS.NET 在 NewFolder 這個子文件夾中添加了一個叫 Images.resources 的資源文件，那麼我們應該用以下代碼獲取這些資源，假設 default namespace 是 MyDefault：
ResourceManager res = new ResourceManager("MyDefault.NewFolder.Images", this.GetType().Assembly);
但如果我們用 VB.NET 的話，就應該這樣：
Dim res As New ResourceManager("MyDefault.Images", Me.GetType().Assembly)
推薦工具
resgen.exe：SDK 中的工具，專門用來做資源文件類型之間的轉換。支持 .txt <-> .resx <-> .resources 之間的轉換。
Resourcer：專門用來創建資源文件，簡單易用，支持 .resx 與 .resources 文件格式。（http://www.aisto.com/roeder/dotnet）
.NET Reflector：用來瀏覽 Assembly。如果你不確定一個資源文件的完整名時可以用這個工具在 Assembly 中查看。（http://www.aisto.com/roeder/dotnet）
總結
本文中談及了以下內容：
什麼是資源
什麼是資源文件
.NET 中有哪幾類資源文件
如何定義資源文件的邏輯位置
調用資源文件的幾種方法
本文通過正確定位資源文件而解決了那個非常時髦的 MissingManifestResourceException。本文給了您一個很豐富資源調用經驗。想讓您完全瞭解有關資源文件的任何可能問題，當然也會有漏洞。如果有的話希望大家諒解！
參考信息
以下是一些文檔的鏈接，如果您的幫助是中文的話請在 MSDNVS 後添加".2052"：
Resource File Generator (Resgen.exe)
ms-help://MS.VSCC/MS.MSDNVS/cptools/html/cpgrfresourcefilegeneratorutilityresgenexe.htm
Resources in Applications
ms-help://MS.VSCC/MS.MSDNVS/cpguide/html/cpconcreatingusingresources.htm
Resource Fallback Process
ms-help://MS.VSCC/MS.MSDNVS/cpguide/html/cpconpackagingdeployingresources.htm #cpconpackagingdeployingresourcesanchor1
關於作者
作者：袁偉（Kefroth）
電子郵件：[email protected]