C＃建立和使用資源檔

建立

建立資源檔

    資源檔顧名思義就是存放資源的檔案。資源檔在程式設計中有著自身獨特的優勢，他獨立於來源程式，這樣資源檔就可以被多個程式使用。同時在程式設計的時候，有時出於安全或者其他方面因素的考慮，把重要東西存放在資源檔中，也可以達到保密、安全的效果。那麼Visual C#所使用的資源檔中到底存放哪些東西呢？在用Visual C#建立資源檔大致可以存放三種類型的資料資源，分別是位元組數組、各種對象和字串。本文將結合一個程式例子來具體說明用Visual C#是如何建立資源檔的。

一．用Visual C#在建立資源檔用到的一些概念和理論：
在.Net FrameWork SDK中的一個名字叫System.Resources名稱空間，在此名稱空間中為應用程式提供了許多建立、儲存和使用資源檔的類和介面。其中有一個類叫ResourceWriter，Visual C#就是通過調用這個類來實現建立、儲存資源檔的。

二．Visual C#如何建立資源檔：
首先要繼承一個ResourceWriter類，然後調用ResourceWriter類的一個方法Generate ( )，就可以產生一個資源檔了。具體語句如下：

ResourceWriter rw = new ResourceWriter ( "My.resources" ) ;
rw.Generate ( ) ;

此時在磁碟的中就會產生一個名稱為"My.resources"的資源檔，但此時的資源檔沒有任何內容，下面我們就來看看如何往資源檔中添加資源。

三．在資源檔中添加資源：
在ResourceWriter類中提供了一個AddResource ( )方法，這個方法的作用就是往資源檔中添加資源的。在Visual C#中對不同的資源有著不同的加入方式。

（1）.加入位元組數組，文法格式為：

public void AddResource ( string , byte [ ] ) ;

注釋：其中string是在使用資源檔的時候，此位元組數組在程式中的的唯一識別碼

（2）.加入對象，文法格式為：

public void AddResource ( string , object );

注釋：其中string是在使用資源檔的時候，此對象在程式中的唯一識別碼

在本文程式中，我們利用這種調用方式來加入表徵圖和圖象，具體如下：

Icon ico = new Icon ( "Demo.ico" ) ;
Image canceloff = Image.FromFile ("cancel-off.png") ;
Image cancelon = Image.FromFile ( "cancel-on.png" ) ;
Image cancelover = Image.FromFile ( "cancel-over.png" ) ;
Image okdown = Image.FromFile ( "ok-down.png" ) ;
Image okoff = Image.FromFile ( "ok-off.png" ) ;
Image okon = Image.FromFile ( "ok-on.png" ) ;

rw.AddResource ( "demo.ico" , ico ) ;//在資源檔中加入表徵圖
//以下是在資源檔中加入圖象
rw.AddResource ( "cancel-off.png" , canceloff ) ;
rw.AddResource ( "cancel-on.png" , cancelon ) ;
rw.AddResource ( "cancel-over.png" , cancelover ) ;
rw.AddResource ( "ok-down.png" , okdown ) ;
rw.AddResource ( "ok-off.png" , okoff ) ;
rw.AddResource ( "ok-on.png" , okon ) ;

（3）.加入字串，具體文法如下：

public void AddResource ( string1 , string2) ;

注釋：其中string1是在使用資源檔的時候，此字串在程式中的唯一識別碼在本文的程式中，是如此使用的：

rw.AddResource ( "MyStr" , "從資源檔中讀取字串！" );

至此我們已經建立了一個資源檔，並且在資源檔中加入了若干個資源，當然在這之後，還應該注意，儲存此資源檔，並關閉資源檔，具體如下：

rw.Close ( ) ;

四．建立資源檔的來源程式代碼：
通過上面的論述，我們不難理解下面這些代碼。下列程式碼的作用就是，建立一個名稱為"My.resources"資源檔，並且在此資源檔中加入一個表徵圖資源，若干個圖象資源，和一個字串資源。具體代碼如下：

CreatResources.cs：
using System ;
using System.Drawing ;
using System.Resources ;

class CreatResource
{
public static void Main ( )
{
ResourceWriter rw = new ResourceWriter ( "My.resources" ) ;
Icon ico = new Icon ( "Demo.ico" ) ;

Image canceloff = Image.FromFile ("cancel-off.png") ;
Image cancelon = Image.FromFile ( "cancel-on.png" ) ;
Image cancelover = Image.FromFile ( "cancel-over.png" ) ;
Image okdown = Image.FromFile ( "ok-down.png" ) ;
Image okoff = Image.FromFile ( "ok-off.png" ) ;
Image okon = Image.FromFile ( "ok-on.png" ) ;

rw.AddResource ( "demo.ico" , ico ) ;

rw.AddResource ( "cancel-off.png" , canceloff ) ;
rw.AddResource ( "cancel-on.png" , cancelon ) ;
rw.AddResource ( "cancel-over.png" , cancelover ) ;
rw.AddResource ( "ok-down.png" , okdown ) ;
rw.AddResource ( "ok-off.png" , okoff ) ;
rw.AddResource ( "ok-on.png" , okon ) ;

rw.AddResource ( "MyStr" , "從資源檔中讀取字串！" ) ;
rw.Generate ( ) ;
rw.Close ( ) ;
}
}

最好還要提醒一下，在成功編譯成執行檔案後，在執行此檔案的時候，必須保證在此執行檔案的相同目錄，存在上面代碼中提到名稱的表徵圖和圖象，否則在建立資源檔的時候是會出錯的。

五．總結：
可見用Visual C#建立資源檔並不是一個複雜的過程，在下一篇文章中，我們將介紹如何在Visual C#使用資源檔中資源。這才是Visual C#資源檔編程的重點和痛點。當然文中所使用的資源檔就是以本文中建立的資源檔。

使用資源檔

    在《Visual C＃資源檔編程--建立資源檔》中已經介紹了如何用Visual C＃建立資源檔。本文將接著上篇文章的話題來探討資源檔另外一個問題，在Visual C＃如何使用資源檔。在上一篇文章中，我們已經成功的建立了一個名稱為"My.resources"的資源檔。這個資源檔中包含有一個表徵圖資源，在檔案中的名稱為"demo.ico"，若干個圖片資源和一個字串資源，在檔案中的名稱為"MyStr"。我們將以上一篇文章建立的此資源檔為對象，結合一個具體的程式例子來看一下用Visual C＃如何使用資源檔。
一．本文程式設計和啟動並執行軟體環境：
（1）.微軟公司視窗2000伺服器版

（2）..Net FrameWork SDK Beta 2

二．程式設計中的一些概念和理論：
程式設計時涉及到的概念和理論主要是二種變數的相互轉換。這就是二種變數就是所謂的實實值型別變數（Value Type Variable）和參考類型變數（Reference Type Variable）。而二者之間的相互轉換，在Visual C＃中被稱為裝箱（Boxing）和出箱（Unboxing）。所謂裝箱就是把實實值型別變數轉換成參考類型變數的過程，反之就是出箱。那麼什麼類型的變數是參考類型的變數，什麼類型的變數又是實實值型別變數呢？這二者之間有什麼區別嗎？在Visual C＃中的參考類型就是泛指這些類型，如：Object、Class、Interface、Delegate、String、Array等。這些類型定義的變數就是參考類型變數。而實實值型別就是平常的平常使用的整型、布爾型、枚舉型等，由這些類型定義的變數就是實實值型別變數。他們之間的最大區別是參考類型變數是指向實體物件的指標，而實實值型別變數就是實在的實體物件。由於裝箱和出箱是一個概念性很強的操作過程，詳細介紹需要很大的篇幅。而這超出了本文探討的主要範疇。所以本文只介紹和程式相關的操作即出箱。具體的操作步驟，將在下一屆結合程式來介紹。

三．程式設計的思路已經重要步驟的解決方案：
（1）.如何在程式編譯的時候中嵌入資源。資源檔和程式是二個獨立的檔案，要把資源檔嵌入到最後產生的程式中，需要在編譯的時候加上"/resource"命令，這個命令可以簡寫為"/res"。在本文中程式的名稱為"use.cs"，資源檔的名稱為"My.resources"，則把資源嵌入程式的編譯命令如下：

Csc.exe /res:My.resources use.cs

（2）.如何在程式管理資源檔中的資源：

在.Net FrameWork SDK這提供了一個關於資源檔建立和使用的名稱空間--System.Resources。在這個名稱空間中有一個Class為ResourceManager，這個Class的主要作用就是管理並使用資源檔。Visual C＃是通過這個類來管理並使用嵌入程式中的資源檔中的資源。下列代碼就是定義一個ResourceManager類來管理嵌入程式資源檔中的資源：

ResourceManager rm = new ResourceManager ( "Images" , Assembly.GetExecutingAssembly ( ) ) ;

（3）.如何在程式中使用資源檔中的資源：

在上一篇文章中，我們已經瞭解到在建立資源檔的時候，使用了AddResource ( )方法來加入資源，他的文法中的第一個參數是使用者可以定義的字串，這個字串就是資源在資源檔的唯一標識，在程式設計中，就是通過這個唯一識別碼來使用某個資源的。那麼如何在程式中通過這個標識符來得到所需資源？這就要使用到ResourceManager類中的GetObject（）和GetString（）方法。這二個方法作用是獲得指定的資源。下面是這二個方法的文法：

object GetSting（String）
object GetObject（String）

其中的"String"就是資源在資源檔中的那個唯一識別碼。細心的讀者可能已經注意到，這二個方法的傳回值都是一個Object類型的變數，也就是一個參考類型的變數，而在程式中的字串或者圖象等，是一個實實值型別變數。這就需要進行轉換，而這種轉換就是上面所說的裝箱和出箱。下列代碼是從資源檔中提取字串、圖象和表徵圖資源：

提取字串資源：

String s = ( ( String ) rm.GetString ( "MyStr" ) ) ;

提取表徵圖資源：

Icon icoDemo = ( ( Icon ) rm.GetObject ( "demo.ico" ) ) ;

提取圖象資源：

Image a = ( ( Image ) ( rm.GetObject ( "ok-off.png" ) ) ) ;

四．結合一個程式例子來看一下，資源檔的具體使用方法：
下面的程式例子所使用的資源檔是上一篇文章中建立的資源檔"My.resources"，程式中定義了三個Lable組件，其中的二個的作用是顯示資源檔中圖象資源，另外一個的作用是顯示資源檔中字串資源，程式的表徵圖是取自資源檔中的表徵圖資源。下面是程式的原始碼：

using System ;
using System.Drawing ;
using System.Collections ;
using System.ComponentModel ;
using System.Windows.Forms ;
using System.Data ;
using System.Resources ;
using System.Reflection ;
public class Form1 : Form
{
private Label lblOK ;
private Label lblCancel ;
private System.ComponentModel.Container components = null ;
private Label lblResource ;
public Form1 ( )
{
//初始化表單中的組件
InitializeComponent ( ) ;
}
//清除程式中使用過的資源
protected override void Dispose ( bool disposing )
{
if ( disposing )
{
if ( components != null )
{
components.Dispose ( ) ;
}
}
base.Dispose ( disposing ) ;
}
private void InitializeComponent ( )
{
ResourceManager rm = new ResourceManager ( "Images" , Assembly.GetExecutingAssembly ( ) ) ;
this.lblOK = new Label ( ) ;
this.lblCancel = new Label ( ) ;
this.lblResource = new Label ( ) ;
this.SuspendLayout ( ) ;

this.lblOK.BackColor = System.Drawing.Color.White ;
//使用資源檔中的圖象資源
this.lblOK.Image = ( ( Image ) ( rm.GetObject ( "ok-off.png" ) ) ) ;
this.lblOK.Location = new System.Drawing.Point ( 24 , 40 ) ;
this.lblOK.Name = "lblOK" ;
this.lblOK.Size = new System.Drawing.Size ( 75 , 23 ) ;
this.lblOK.TabIndex = 0 ;
this.lblOK.Click += new System.EventHandler ( this.lblOK_Click ) ;
this.lblOK.MouseEnter += new System.EventHandler ( this.lblOK_MouseEnter ) ;
this.lblOK.MouseLeave += new System.EventHandler ( this.lblOK_MouseLeave ) ;
//出箱
//使用資源檔中的圖象資源
this.lblCancel.Image = ( ( Image ) ( rm.GetObject ( "cancel-off.png" ) ) ) ;
this.lblCancel.Location = new System.Drawing.Point ( 152 , 40 ) ;
this.lblCancel.Name = "lblCancel" ;
this.lblCancel.Size = new System.Drawing.Size ( 75 , 23 ) ;
this.lblCancel.TabIndex = 1 ;
this.lblCancel.Click += new System.EventHandler ( this.lblCancel_Click ) ;
this.lblCancel.MouseEnter += new System.EventHandler ( this.lblCancel_MouseEnter ) ;
this.lblCancel.MouseLeave += new System.EventHandler ( this.lblCancel_MouseLeave ) ;

this.lblResource.Location = new System.Drawing.Point ( 88 , 8 ) ;
this.lblResource.Name = "lblResource" ;
this.lblResource.TabIndex = 2 ;
//出箱
//使用資源檔中的字串資源
this.lblResource.Text = ( ( String ) rm.GetString ( "MyStr" ) ) ;

this.AutoScaleBaseSize = new System.Drawing.Size ( 5 , 13 ) ;
this.ClientSize = new System.Drawing.Size ( 240 , 101 ) ;
this.Controls.Add ( lblResource ) ;
this.Controls.Add ( lblCancel ) ;
this.Controls.Add ( lblOK ) ;
//出箱
//使用資源檔中的表徵圖資源
Icon icoDemo = ( ( Icon ) rm.GetObject ( "demo.ico" ) ) ;
this.Icon = icoDemo ;
this.Name = "Form1" ;
this.Text = "Visual C＃中使用資源檔！" ;
this.ResumeLayout ( false ) ;

}
static void Main ( )
{
Application.Run ( new Form1 ( ) ) ;
}
private void lblOK_MouseEnter ( object sender , System.EventArgs e )
{
ResourceManager rm = new ResourceManager ( "Images" , Assembly.GetExecutingAssembly ( ) ) ;
this.lblOK.Image = ( ( Image ) ( rm.GetObject ( "ok-on.png" ) ) ) ;
}

private void lblOK_MouseLeave ( object sender , System.EventArgs e )
{
ResourceManager rm = new ResourceManager ( "Images" , Assembly.GetExecutingAssembly ( ) ) ;
this.lblOK.Image = ( ( Image ) ( rm.GetObject ( "ok-off.png" ) ) ) ;
}

private void lblOK_Click ( object sender, System.EventArgs e )
{
ResourceManager rm = new ResourceManager ( "Images" , Assembly.GetExecutingAssembly ( ) ) ;
this.lblOK.Image = ( ( Image ) ( rm.GetObject ( "ok-down.png" ) ) ) ;
}

private void lblCancel_MouseEnter ( object sender , System.EventArgs e )
{
ResourceManager rm = new ResourceManager ( "Images" , Assembly.GetExecutingAssembly ( ) ) ;
this.lblCancel.Image = ( ( Image ) ( rm.GetObject ( "cancel-onr.png" ) ) ) ;
}

private void lblCancel_MouseLeave ( object sender , System.EventArgs e )
{
ResourceManager rm = new ResourceManager ( "Images" , Assembly.GetExecutingAssembly ( ) ) ;
this.lblCancel.Image = ( ( Image ) ( rm.GetObject ( "cancel-off.png" ) ) ) ;
}

private void lblCancel_Click(object sender, System.EventArgs e)
{
ResourceManager rm = new ResourceManager ( "Images" , Assembly.GetExecutingAssembly ( ) ) ;
this.lblCancel.Image = ( ( Image ) ( rm.GetObject ( "cancel-over.png" ) ) ) ;
}
}

五．總結：
至此我們已經完成了在Visual C＃資源檔方面編程的全部內容，其中的主要內容就是建立資源檔和使用資源檔二大方面，我想通過這二篇文章的介紹，你對資源檔應該有了一個比較全面的認識了吧！