需求:建立一個類庫TestControls,這個類庫中包含若干ASP.NET伺服器控制項,其中有一些會調用用戶端的JavaScript函數,把這些函數放入TestScript.js中。
其實是很簡單的需求,但是在我沒有搞定之前,在網上確實找了很多文章,大家提了這樣那樣的問題,也提了這樣那樣的解決方案,但最後還是自己碰運氣搞定的,唉。把經驗分享出來,希望大家不要再走彎路。
下面示範一個例子,把上面的需求再簡化一下,類庫還是要建立的,裡面只有一個伺服器控制項TestControl,這個控制項沒有介面,只負責把JavaScript指令碼註冊到網頁中即可,為了快速看到效果,指令檔裡面不加函數,只放一句Alert,這樣只要註冊成功了,開啟頁面的時候就會看到親愛的提示框,表明調試通過。
首先需要建立一個類庫工程,名稱為TestControls。
把預設帶的Class1.cs直接刪除。
建立一個類TestControl,從System.Web.UI.WebControls.WebControl繼承。
建立一個JavaScript指令碼TestScript,將該指令碼的“產生操作”屬性的值,從“內容”修改為“內嵌資源”。
建立一個Web項目用於測試,Web項目需要在Web.config中做一些設定。
TestScript.js
alert("script is registered.");
TestControl.cs
using System;
using System.Collections.Generic;
using System.Text;
using System.Web.UI.WebControls;
using System.Web;
using System.Security.Permissions;
namespace TestControls
{
[AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal)]
public class TestControl : WebControl
{
protected override void OnInit(EventArgs e)
{
base.OnInit(e);
this.Page.ClientScript.RegisterClientScriptResource(this.GetType(), "TestControls.TestScript.js");
}
}
}
AssemblyInfo.cs(增加以下代碼)
using System.Web.UI;
[assembly: WebResource("TestControls.TestScript.js", "application/x-javascript")]
Web.config
<pages>
<controls>
<add tagPrefix="tc" assembly="TestControls" namespace="TestControls"/>
</controls>
</pages>
Default.aspx
<tc:TestControl runat="server" ID="TestControl1" />
基本上以上幾個步驟都做到了,結果是很確定的。
總結一下,有幾個要點:
1、JavaScript檔案必須修改為“內嵌資源”。
2、嵌入JavaScript檔案的類庫,要增加WebResource的說明,可以放在單獨檔案中,也可以放在AssemblyInfo.cs中。
3、調用JavaScript的類,必須增加安全記事,不加就無法調用。
4、指令檔名稱,嚴格的按照命名空間加上檔案名稱的格式,差一點都不可以。
5、控制項的調用