ASP.NET 中對 JavaScript 的支援

 

在 ASP.NET 中，System.Web.UI.ClientScriptManager 用來管理指令碼，此類可以通過頁面對象的 ClientScript 屬性取得。通過這個對象可以管理網頁中的指令碼。

 

由於可能多次向同一個頁面中加入指令碼，或者需要檢查頁面中是否已經加入過指令碼，ClientScriptManager 的許多方法使用了字典集合來進行檢查，註冊一個指令碼內容的時候，需要提供一個字串類型的資源名稱，這個名稱可以用來檢查是否已經在頁面中加入過同樣的指令碼。

 

從方法的用途可以分為兩類，一類用於檢查頁面中是否已經加入過資源，這一類的方法以 IsRegister 開頭，另一類用於在頁面對象中註冊指令碼資源，這一類的方法以 Register開頭。

 

根據註冊的內容，我們還可以將這些方法分成如下的類別：

 

數組

定義 JavaScript 數組，產生一個 JavaScript 的數組到頁面中。

在 JavaScript 程式中，可以如下定義數組

 

var arrayName = new Array() { 數組的初值 };

例如：

var myArray = new Array() { “One”, “Two”, “Three” };

 

public void RegisterArrayDeclaration(

       string arrayName,

       string arrayValue

)

 

參數：

arrayName：數組的名字

arrayValue：數組的值，用字串表示，就是在 JavaScript 程式中定義在花括弧內的內容

 

指令碼塊

 

註冊指令碼塊，一般用於將 JavaScript 的函數註冊到頁面中

 

用於判斷是否已經註冊過指定的指令碼塊

public bool IsClientScriptBlockRegistered(

       string key

)

 

將指令碼塊註冊到頁面中

public void RegisterClientScriptBlock(

       Type type,

       string key,

       string script

)

 

啟動指令碼塊

 

註冊啟動指令碼塊，一般用於將需要直接執行的 JavaScript 語句註冊到頁面中

 

判斷是否已經註冊過指定的啟動指令碼塊

public bool IsStartupScriptRegistered(

       string key

)

 

註冊啟動指令碼塊

public void RegisterStartupScript(

       Type type,

       string key,

       string script

)

 

包含外部的指令檔

 

判斷是否已經註冊過指定名稱的指令檔

public bool IsClientScriptIncludeRegistered(

       string key

)

 

註冊包含外部的指令檔

public void RegisterClientScriptInclude(

       string key,

       string url

)

 

頁面元素的屬性

 

為頁面元素定義新的屬性並賦值

public void RegisterExpandoAttribute(

       string controlId,

       string attributeName,

       string attributeValue

)

controlId               頁面元素的 ID

attributeName        新增加的屬性名稱

attributeValue       屬性的值

 

隱藏欄位

 

在頁面中增加隱藏欄位

public void RegisterHiddenField(

       string hiddenFieldName,

       string hiddenFieldInitialValue

)

hiddenFieldName          隱藏欄位的名字

hiddenFieldInitialValue 隱藏欄位的值

 

註冊當執行表單提交動作時執行的指令碼

public void RegisterOnSubmitStatement(

       Type type,

       string key,

       string script

)

 

在頁面中產生 javascript:__doPostBack( 元素ID, 參數 ) 的指令碼

 

public string GetPostBackClientHyperlink(

       Control control,

       string argument

)

 

與前面相比，沒有 javascript: 首碼，用於用戶端指令碼編程中，產生一個用來回傳請求道伺服器的指令碼字串。

public string GetPostBackEventReference(

       Control control,

       string argument

)

 

資源

 

產生到編譯到程式集中的資源的連結

public string GetWebResourceUrl(

       Type type,

       string resourceName

)

資源可以是指令檔，圖片檔案或者任何其它的靜態檔案。這個方法常常和下面的 RegisterClientScriptResource 方法聯合使用。

 

註冊已經編譯到程式集中的 JavaScript 資源檔嵌入到頁面中

public void RegisterClientScriptResource(

       Type type,

       string resourceName

)

 

附

在程式集中加入資源的方法：

1． 將檔案包含在項目中

2． 選擇該檔案的屬性，將“產生操作”屬性設為“內嵌資源”。

3． 注意此資源的名稱前面會自動加上預設的命名空間，比如項目的預設命名空間為 com.myspace，此檔案為 jQuery.js，如果此檔案加入到項目的根目錄，則資源名稱為 com.myspace.jQuery.js。如果被加入到項目的子檔案夾中，還有再加上子檔案的名稱，例如：如果加入到項目根目錄下的 Scripts 子檔案夾中，則資源的名稱變為：com.myspace.Scripts.jQuery.js。

4． 為程式集標註包含資源的程式集，可以有兩種方法：

a)         在 assembly.cs 中，增加一個標籤

[assembly.WebResource[“資源名稱”, “類型”]

b)        在項目的任何一個 cs 檔案中，在命名空間之外增加

[assembly.WebResource[“資源名稱”, “類型”]

 

5． 使用GetWebResourceUrl 可以得到基於 WebResource.axd 的訪問路徑。