ASP.NET文件類型與資源文件簡介
.NET文件類型解析
*.resx是資源文件。每個頁面都有一個資源文件相對應。
global.asax是global.asa的.net版
global.asax.vb是global.asax的后臺文件。
*.ascx是一個用戶自定義控件。
*.ascx.vb是自定義控件的代碼文件,C#的是*.ascx.cs
*.ascx.resx是自定義控件的資源文件。
*.aspx.vb是*.aspx頁面的后臺代碼。
web.config是整個Web Application的配置文件。
*.vbproj是VB.NET的工程文件。
*.vsdisco是Web Service的文件。
*.vbproj.webinfo是VB.NET工程文件的Web Application文件。
*.sln是VS.NET的解決方案文件。
其中global.asax,global.asax.vb,web.config,*.vbproj,*.vsdisco,*.vbproj.webinfo,*.sln都是在建立一個VB.NET的Web Application工程的時候自動產生的。
ASP.NET的頁面文件是*.aspx,每個頁面對應一個*.resx資源文件和一個*.aspx.vb的代碼文件
.NET文件類型:什么是資源文件
在 .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 中。
.NET文件類型:資源文件類型
System.Resources 名字空間支持三種資源文件:
.txt 文件,只能有字符串資源。因為不能被嵌入到 Assembly 中,所以很容易暴露,被客戶修改。***缺點是僅支持字符串資源,所以不推薦使用。
.resx 文件,由 XML 組成,可以加入任何資源,包括二進制。同樣不能被嵌入到 Assembly 中。在 System.Resources 名字空間中有專用讀寫的類。VS.NET 創建這種文件然后將其轉成 .resources 文件并根據設置將其嵌入到 Assembly 中。
.resources 文件,PE 格式,可以加入任何資源。唯一可以被嵌入到 Assembly 的文件,在 System.Resources 名字空間中有專用讀寫的類。
.NET文件類型:調用資源文件的幾種方法
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 文件格式。
.NET Reflector:用來瀏覽 Assembly。如果你不確定一個資源文件的完整名時可以用這個工具在 Assembly 中查看。
【編輯推薦】