[声明]本文转载自闲云野鹤的系列文章『将自定义.NET控件嵌入IE浏览器』,本文旨在学习。
利用Visual Studio .NET开发自定义的WinForm控件,恐怕大家都已经很熟悉了。正常情况下,这种控件只能用在基于.NET的Windows Application程序开发上,而无法直接嵌入到IE,这不免让人感觉遗憾。
毕竟.NET控件已经不同于在Win32下用Delphi或C++Builder开发的自定义控件。基于.NET开发的任何受控装配件(Assembly)都是IL代码,可以在运行期被.NET FrameWork进行反射(Reflection)、安全检查。应该有办法让这种特殊控件被IE使用。
经过几日的研究,终于找到一个方法可以将.NET WinForm自定义控件即用于普通的Windows Application开发,又可以将其当做ActiveX控件直接嵌入到IE中,同js脚本语言进行互动(客户端需要安装.NET FrameWork)。这无疑可以大大的节省客户端代码在Windows和Web应用的移植工作,并保持控件代码的最大复用。
原理为:.NET自定义控件没有普通ActiveX的GUID唯一标示,同时为了解决以往版本冲突引起的“DLL地狱”问题,.NET控件不再向注册表进行类型的注册,而是不同的版本部署在应用程序当前目录或GAC(Globle Assembly Cache)中。.NET可以为.NET控件产生强名称的代理,从而提供给其他语言比如VB、VC、Delphi等调用。我们只需要在装配件文件(C#下为AssemblyInfo.cs)中就可以设置这些开关,也可以在VS.NET的项目属性中设置。这样.NET就可以为我们自动产生ClassLibrary对应的OLE对象特征。然后我们再创建ActiveX用到的事件接口、安全接口等。
第一步――创建.NET自定义控件。
下面用Visual Studio.NET 2005 Professional为开发工具进行介绍。
创建新项目,选择Windows Control Library。名称为默认的:WindowsControlLibrary1。
在界面中放置如下控件:TextBox、Button。这就是界面上所有的内容。双击界面中的Button控件,书写如下代码:
private void button1_Click(object sender, EventArgs e) { StreamWriter bplStreamWriter = new StreamWriter( System.Environment.GetEnvironmentVariable("SystemDrive")+"\\a.txt", true); bplStreamWriter.WriteLine(DateTime.Now.ToUniversalTime() + "\tInserted Text by .Net WinFormControl."); bplStreamWriter.Close(); }
|
该部分代码表示在系统盘根目录下创建一个文件,并添加一行文本。为了能调用StreamWriter类,我们要添加System.IO名称空间。
同时添加自定义控件的属性:ButtonCaption。
[Category("自定义控件的属性")] [Description("设置按钮的文本内容")] public string ButtonCaption { get { return button1.Text; } set { button1.Text = value; } } |
添加委托(delegate)并创建按键点击事件:
// 声明按键点击事件类型 public delegate void ButtonClickHandler(string SendMsg); public partial class UserControl1 : UserControl { // 声明按键点击事件 public event ButtonClickHandler OnButtonClick;
|
在刚才的按钮点击函数中增加点燃事件的代码:
private void button1_Click(object sender, EventArgs e) { …… if (OnButtonClick != null) OnButtonClick(textBox1.Text); } |
增加公共方法SetText:
public void SetText(string text) { textBox1.Text = text; } |
此时点击运行,可以利用VS.NET 2005自带的控件容器运行我们的控件。通过属性编辑器可以验证ButtonCaption属性。点击Button可以发现在系统盘创建文件,并添加了文本内容。您也可以新创建一个Windows Application项目,将这个控件加入后,测试其属性、事件和方法,这里就不介绍了。
上一篇我介绍了如何创建普通的.NET控件。为了能让.NET控件嵌入到IE中,这次我们来
为控件添加COM特性。
打开项目属性,在Application页面中点击“Assembly Information…”按钮,打开
Make assembly COM-Visible选项。
进入项目属性的Build页面,打开Register for COM interop选项。
保存配置后进行Build,此时的.NET控件已经具备普通OLE对象的特性。打开VS.NET自带
的OLE/COM对象查看器(默认目录为C:\Program Files\Microsoft Visual Studio
8\Common7\Tools\Bin\OleView.Exe)。我们可以在.NET Category下看到我们创建的控
件WindowsControlLibrary1.UserControl1。所有的信息已经被自动注册,包括控件的
强路径。
其实,此时的.NET控件已经可以放入IE了,只是还不能算是合格的ActiveX控件,但仍
然是合格的.NET控件。
我们编写一个htm文件来测试该控件。htm文件内容如下:
文本框: <HTML>
<HEAD>
<meta http-equiv="Content-Type" content="text/html; charset=GBK">
</HEAD>
<body bgcolor="#D8EEFB">
<OBJECT id="UserControl1"
classid="WindowsControlLibrary1.dll#WindowsControlLibrary1.UserControl1"
VIEWASTEXT></OBJECT>
<br><br><br><br>
<input type='button' value=' 调用方法' onclick='UserControl1.SetText("Hello
World!");'>
<br><br><br><br>
<input type='button' value=' 设置属性' onclick='UserControl1.ButtonCaption =
"Set";'>
</body>
</HTML>
将htm文件和WindowsControlLibrary1.dll部署在IIS的虚拟目录中,用浏览器浏览,就
可以看到如下效果。
虽然.NET控件可以被显示在IE中,但是.NET FrameWork能动态检查代码的安全性,因为
没有安全授权,不安全的代码将无法执行。比如点击按钮,我们可以得到如下提示。
有意思的是,只要该控件在装载时没有不安全代码,IE就不会有任何的提示,不同于IE
对加载ActiveX时的安全警告。这样说明IE对.NET的代码安全性是交给FrameWork处理
的。因此此类控件也有一种用处,就是不必数字签名,就可以加载显示在用户的IE浏览
器中,并顺利执行安全的受控代码。当然前提是用户需要安装.NET FrameWork。
此时我们还是没有得到一个真正的ActiveX控件,虽然它可以通过IIS发布在Web页面
中,也可以执行安全的代码。但存在如下局限性:无法发布到其他Web服务器上、无法
访问本地资源、js脚本无法响应控件的事件等。
下一篇我们将讨论.NET自定义控件如何实现所有的COM对象接口,包括属性、方法、事
件。并利用js脚本在Web页面中形成互动。
这次我们将讨论.NET自定义控件如何实现所有的COM对象接口,包括属性、方法、事件。并利用js脚本在Web页面中形成互动。
按照上一篇我们介绍的将.NET控件添加COM特性后,VS.NET已经自动注册了该控件的属性、方法和事件,只是还需要我们实现事件接口。
为了实现事件接口,我们需要添加如下代码:
[ComVisible(true)] [Guid("43BCDB16-0281-487b-BB53-997546122442")] [InterfaceType(ComInterfaceType.InterfaceIsIDispatch)] public interface UserControl1Events { [DispId(0)] void OnButtonClick(string SendMsg); } |
为了保证Guid的有效性,我们可以使用VS.NET的Create GUID工具创建。接口中的方法就是我们要触发的事件函数。该函数的声明要参照我们控件中的事件,名称必须保持一致。
public event ButtonClickHandler OnButtonClick; |
下一步我们就是要为我们的控件类创建Guid,并实现上面声明的事件接口。这里我们不要试图去实现事件接口,而是要用属性的方式去引用该COM接口。
[Guid("FBA0FCC2-D75F-40a5-9C8C-1C9D03813731")] [ComSourceInterfaces(typeof(UserControl1Events))] public partial class UserControl1 : UserControl { |
Build后我们已经得到一个具有公共属性、方法和事件的COM控件了。
我们创建html文件来测试新的ActiveX控件,代码如下:
<HTML> <HEAD> <meta http-equiv="Content-Type" content="text/html; charset=GBK"> </HEAD> <script language='javascript' for='usercontrol1' event='OnButtonClick(Message)'> alert("响应ActiveX触发的事件成功。"+Message); window.defaultStatus = "OnButtonClick()"; </script>
<body> <object id="usercontrol1" classid="clsid:FBA0FCC2-D75F-40a5-9C8C-1C9D03813731"> </object> <br><br><br><br> <input type='button' value=' 调用ActiveX方法' onclick='usercontrol1.SetText("Hello World!");'> <br><br><br><br> <input type='button' value=' 设置ActiveX属性' onclick='usercontrol1.ButtonCaption = "Set";'>
</HTML> |
这次我们不再需要IIS,可以直接运行该html文件。可以得到下面的结果:
我们的.NET控件已经可以象普通的ActiveX控件使用。同时,该.NET控件也可以继续被.NET 的Windows Application使用。(全篇完)