activeX控件开发文章(转载)
用C#编写ActiveX控件(一)
前些日子做一个Web项目,必须自己编写一个ActiveX控件。如今的ActiveX控件大多是使用VB/C++来开发的,而我对他们并不熟悉,因此考虑使用熟悉的C#编写ActiveX控件。
首先,建立一个WinForm控件项目HelloWorld,并拖入一个Label控件,文字设为HelloWorld,如图:
UserControl1.cs内容如下:
using System.Collections;
using System.ComponentModel;
using System.Drawing;
using System.Data;
using System.Windows.Forms;
namespace HelloWorld
{
/// <summary>
/// UserControl1 的摘要说明。
/// </summary>
public class Demo : System.Windows.Forms.UserControl
{
private System.Windows.Forms.Label label1;
/// <summary>
/// 必需的设计器变量。
/// </summary>
private System.ComponentModel.Container components = null;
public Demo()
{
// 该调用是 Windows.Forms 窗体设计器所必需的。
InitializeComponent();
// TODO: 在 InitComponent 调用后添加任何初始化
}
/// <summary>
/// 清理所有正在使用的资源。
/// </summary>
protected override void Dispose( bool disposing )
{
if( disposing )
{
if( components != null )
components.Dispose();
}
base.Dispose( disposing );
}
组件设计器生成的代码
}
}
此时编译项目,可以生成HelloWorld.dll。将此dll拷贝到IIS的虚拟根目录下,然后建立一个helloworld.htm的文件,html代码如下:
<object id="helloworld" classid=’http://localhost/HelloWorld.dll#HelloWorld.Demo’ Width="184" Height="96" VIEWASTEXT> </object>
</body>
如图,控件已经成功在页面上显示了。OK,我们已经完成了第一步。
但是问题到这里还没有解决。不相信?你可以试试在另外一台机器上测试,注意需要修改对应的html代码和URL地址。你可以看到这个在原来显示控件的地方是一个红色的叉,或者还会弹出一个对话框,表示这个控件没有任何权限。出现这个结果是微软的默认设置造成的,作者必须在控件所在的控件的 AssemblyInfo.cs/vb 中执行一个安全声明,声明这个控件必须使用赋予的权限,才可以显示出界面。我们在AssemblyInfo.cs中引用System.Security命名空间,并添加一句:
需要提醒的是,到现在为止,我们编写的还不是真正的ActiveX控件。这个控件到现在为止,还只是能够实现自身的显示,并且不能实现更多的功能,比如实现与脚本的交互或者操作客户端的注册表或者磁盘。这是由于.Net Framework的安全模型所限制的。如果我们希望这个控件突破.Net Framework安全模型的限制,实现与脚本的交互或者操作客户端的注册表或者磁盘的话,必须要让它成为真正的ActiveX控件。下面,我们把刚才的控件变成真正的ActiveX控件。
首先使用 工具—〉创建GUID 生成一个GUID,并修改UserControl1.cs文件。首先增加引用System.Runtime.InteropServices命名空间,并在Demo前面加入一条语句:
注意Guid中的字符串,就是你生成的Guid字符串。它是你所生成的ActiveX控件的唯一标识符。然后修改项目属性,如图:
注意面板中的最后一项,我们唯一需要修改的是将其值改为True。
重新编译。我们使用 工具—〉OLE/COM对象查看器 查看,如图:
可以看到,我们写的HelloWorld.Demo已经被正确识别为COM组件。现在,我们已经可以像使用其它ActiveX控件一样在网页中显示了。在HelloWorld.Demo点击鼠标右键,如图:
选择Copy HTML <object> Tag to Clipboard,可以将代码拷入剪贴板。
现在,我们改写helloworld.htm,html代码如下:
<object id="helloworld"
classid="clsid:9551B223-6188-4387-B293-C7D9D8173E3A" Width="184" Height="96">
</object>
</body>
不过,编写ActiveX控件的任务还没有完成。我们还没有实现脚本互动或者读写I/O,也没有实现ActiveX控件的自动分发。在下一篇Blog中,我会完成ActiveX控件的编写。
在我的上一篇blog中,已经实现了一个最基本的ActiveX控件。当然,我们编写的任务还没有完成。首先,我们先尝试实现和JS的交互能力。
{
if(msg != null)
{
MessageBox.Show(msg);
}
}
<object id="helloworld"
classid="clsid:9551B223-6188-4387-B293-C7D9D8173E3A" Width="184" Height="96"
>
</object>
<br>
<input type='button' onclick='helloworld.ShowMessage(“Hello World!”)' value='Click'>
</body>
现在,重新访问http://localhost/helloworld.htm,单击Click按钮,应该可以实现交互了。
但是结果却很遗憾,我们发现IE跳出了对话框,如图所示:
单击确定之后,我们发现JS报错。根据提示,我们判断可以通过修改IE的设置使控件运行。打开IE的 工具——〉Internet选项——〉安全——〉本地Intranet——〉自定义级别——〉对没有标记为安全的ActiveX控件进行初始化和运行,将其值设为启用。我们刷新页面,现在终于可以正确运行了。
当然,我们不能指望我们的客户和我们一样修改这个值。毕竟,一是操作麻烦,二是给电脑带来了很大的安全风险。在互联网上搜索之后,发现必须要实现IObjectSafety接口,把ActiveX控件标记为安全的ActiveX控件。在搜索MSDN之后,我找到了IObjectSafety接口的定义。这就好办了。首先我们自己用C#实现这个接口:
public interface IObjectSafety
{
// methods
void GetInterfacceSafyOptions(
System.Int32 riid,
out System.Int32 pdwSupportedOptions,
out System.Int32 pdwEnabledOptions);
void SetInterfaceSafetyOptions(
System.Int32 riid,
System.Int32 dwOptionsSetMask,
System.Int32 dwEnabledOptions);
}
注意,这个GUID是不能改的。然后,我们在Demo类里面实现这个接口。增加一下代码:
public void GetInterfacceSafyOptions(Int32 riid, out Int32 pdwSupportedOptions, out Int32 pdwEnabledOptions)
{
// TODO: 添加 WebCamControl.GetInterfacceSafyOptions 实现
pdwSupportedOptions = 1;
pdwEnabledOptions = 2;
}
public void SetInterfaceSafetyOptions(Int32 riid, Int32 dwOptionsSetMask, Int32 dwEnabledOptions)
{
// TODO: 添加 WebCamControl.SetInterfaceSafetyOptions 实现
}
#endregion
重新编译,然后将IE里面的设置改回来。现在,我们发现,和JS的交互已经没有问题了。
这样,一个最基本的ActiveX控件已经写好了。你可以在这个控件的基础上增加任何你需要的功能。到这里,编写控件的任务已经完成了,我们的下一个目标就是发布它
在前面我们已经完成了ActiveX控件的开发,接下来的就是发布它了。
首先,我们建立一个windows安装项目,并将ActiveX控件的主输出添加到项目输出中。然后,改动ActiveX控件的主输出文件,将其Register属性改为vsdrpCOM.如图:
下一步,我们改动项目属性,将引导程序更改为 Web引导程序。很遗憾的是,在 Web引导程序设置 中的安装文件夹URL中必须使用绝对路径,不能使用相对路径。这意味着生成安装程序的时候就必须确定路径,不是很方便。在示例中,我使用了localhost,在发布中可以改为实际的域名。
现在我们生成安装程序,并把相应得程序拷贝到正确的目录中(本例中为默认网站目录下的ActiveX文件夹中)。我们可以直接执行Setup.Exe文件,以验证安装文件的正确性。在我的机器上正确执行了,成功了!
现在我们又要重新改动helloworld.htm文件了。修改后的结果如下:
<body bgcolor='#223344'>
<object id="helloworld"
classid="clsid:9551B223-6188-4387-B293-C7D9D8173E
>
</object>
<br>
<input type='button' onclick='helloworld.ShowMessage("Hello World!")' value='Click'>
</body>
注意,我们在object块中加入了codebase属性,这就是制定的下载控件的位置,可以使用相对路径。别忙,我们现在还不能正确请求这个页面,因为我们还没有对我们的控件进行签名。签名可以采用两种方式,一种是在上面生成安装程序的时候签名,另一种是使用sn.exe签名。推荐大家使用后者,因为可以提供更多选项。本人很懒,就不多写了,大家可以参考csdn上的文章《发布ActiveX》。先给给大家提个醒,在申请证书的时候选择 高级证书申请。
发布Activex | |
1、如果需要创建cab文件,首先需要Cabarc或者Makecab,它们随着Cabinet SDK的安装就有了,Cabinet SDK的下载地址是http://msdn.microsoft.com/workshop/management/cab/cabdl.asp。 Cabarc可以创建、查看或者解出cab里面的文件,而Makecab则只可以用来创建cab文件。 2、制作cab文件时需要将所有的相关文件都包含进去,可以通过Depends(VC自带的)检查需要的文件。使用inf文件将这些东西都写进去。 3、inf搞法:inf文件描述cab中所有的ocx及dll文件,inf通过一些命名区域来提供需要的信息。 怎么写inf 最开始一般是[Version]区: eg: [Version] signature="$XXXX$" AdvancedINF=2.0 接下来就是最重要的[Add.Code]区: eg: [Add.Code] Ctrl1.dll=C1Section Ctrl2.dll=Ctrl2.dll 前面是要下载的文件名,后面是对应这个文件的区域名,可以是任何名字,不过一般都是和文件的名字相同,这样方便维护。还有需要注意是在[Add.Code]区出现的文件要根据依赖性进行排序,例如前面说的ctrl1.dll要依赖于ctrl2.dll,则ctrl2.dll要出现在ctrl1.dll的前面。因为安装时是按照相反的顺序进行的,也就是说先安装ctrl2.dll,然后才是ctrl1.dll,哧哧,记清楚了,不要搞反了。 再接下来是各个文件的区域了 [Ctrl1.dll] file-win32-x86=thiscab RegisterServer=yes clsid={.....} DestDir= FileVersion=1,0,0,0 [Ctrl1.dll]区域中的第一个file值告诉ie到哪里去得到这个dll,file一共包括三个部分,第一部分是file,这个永远都是这样的(至少目前来说);第二部分告诉声明支持的OS,win32表示windows,mac就是苹果MAC OX了;第三部分是CPU类型,比如说x86、 ppc (Power PC)、 mips或者alpha了。 file的值可以取三个一个URL、ignore和thiscab,如果是URL则说明到URL所在的位置去下;如果是ignore说明对于这种OS和CPU,不需要下载这个文件(ctrl1.dll);如果是thiscab很明显就在当前的cab文件中了。 接下来是RegisterServer,可以取两个值yes和no,如果为yes则说明ie要注册该dll,如果是no就不必了; 再下来是DestDir,它的值是dll将要存到本地硬盘的位置,如果它的值是10,则将dll放到\Windows或者\WinNT下;如果是11,则放到\Windows\System或者 \WinNT\System32下;如果是空(就是没有值)则会放到\Windows或者\WinNT下的Downloaded Program Files目录下; 最后是FileVersion,这个就比较明显了,说明了ctrl1.dll的版本号。 有时候我们使用VB来开发控件的时候,需要将VB的虚拟机装上去,它需要一些其它的说明的,简单地讲一下吧: 在[Add.Code]中增加一项MSVBVM60.DLL=MSVBVM60.DLL(以VB6为例)下面是 MSVBVM60.DLL区域: [MSVBVM60.DLL] hook=MSVBVM60.cab_Installer FileVersion=6,0,81,76 FileVersion很明显,是版本号,就不再说发,就说说hook吧。 hook区域是在安装的时候需要执行的区域,它分为两种,一种是有条件的,另外一种是无条件的,无条件的hook区域是必须执行的,反之则根据条件判断是否执行。以[Setup Hooks]标记的区域是无条件区域,如下所示 [Setup Hooks] hookname=section-name [section-name] run=%EXTRACT_DIR%\setup.exe 无条件区域常用来通过一个inf文件执行一个安装程序,这就是我们在资源管理器右键点击一个inf文件时在执行安装这样的菜单的原因了 当ie下载了一个cab文件,如果文件中没有[Add.Code],则处理[Setup Hooks]区域,运行run所指定程序,哧哧,上面就是setup.exe; 条件区域则为在一定条件下执行,前面为MSVBVM60.DLL指定的hook区域就是一个条件区域,如果在MSVBVM60.DLL指定的CLSID或者version不能满足需要而且没有file这个命名值,则执行hook所指定的区域。 [MSVBVM60.cab_Installer] file-win32-x86=http://activex.microsoft.com/controls/vb6/VBRun60.cab run=%EXTRACT_DIR%\VBRun60.exe 上面[MSVBVM60.cab_Installer]是一个hook区域,它也包含了一个file值,指定一个URL,表示MSVBVM60.DLL可以从这个URL下载得到;run则说明了执行哪一个文件 这里有必要说明一下的是,MS对一些常用的Redistributable Microsoft DLLs 可以通过指定CODEBASE属性为http://activex.microsoft.com/controls,这样在cab文件中就中需要包含这些文件,在计算机上有一个文件redist.txt上面的dll就是Redistributable Microsoft DLLs 创建一个cab文件: cabarc N ctrl1.cab ctrl1.inf ctrl1.dll N表示要创建一个新的文件,ctrl1.cab是创建的文件名,ctrl1.inf是cab的inf,后而是需要加到cab里的文件,可以使用通配符。 然后就可以将cab文件放到网页上了 <OBJECT ID="Ctrl1Obj" CLASSID="clsid:....................................." CODEBASE="http://server.com/ctrl1.cab#version=8,0,0,5007"> </OBJECT> 这里也在一个version,不过这里的version是指控件的version,而inf里的是文件的version。 制作电子签名: 首先从下面的网址下载制作签名的工具SignCode,地址是 http://msdn.microsoft.com/workshop/gallery/tools/authenticode/authcode.asp 从签名授权中心如VeriSign或者你的局域网上运行的Microsoft Certificate Server授权服务器得到一个certificate,在申请授权的过程你会得到一个私钥。 也可以使用MakeCert.exe和Cert2Spc.exe创建的私钥进行测试,方法是首先使用MakeCert创建一个X.509的certificate(.cer文件) MakeCert -sv MyKey.pvk n "CN=My Software Company" MyCert.cer 然后利用Cert2Spc将.cer文件转换成为PKCS #7软件发布Certificate(.spc文件), Cert2Spc MyCert.cer MyCert.spc 利用你下载的SignCode对你的cab文件进行电子签名 SignCode -spc MyCert.spc -v MyKey.pvk -t http:// timestamp.verisign.com/scripts/timstamp.dll ctrl1.cab SignCode还可以指定一些其它的参数,就不说了,太长了,哧哧。 虽然可以利用测试的.cer和.spc文件,但是在发布的时候,必须申请。 其实东西在SDK中都有说明,不过都是E文的,慢慢看. |
【原】关于ActiveX插件小项目总结
由于项目需要检测客户端的硬件和网速配置,因此要写个ActiveX插件,首先感谢红马天下的文章《用C#编写ActiveX控件》给我的帮助。
经过大家努力,最后实现效果如下:
1、建立ActiveX组件项目是通过VS建立window控件库项目来建的;
2、项目属性中的“生成”选项卡要把为COM Interop注册选框勾选;
3、“AssemblyInfo.cs”文件中的“[assembly: ComVisible(false)]”要设为true;
4、在控件类上要注明GUID,方便以后object中classid的调用
[Guid("6BE98CB0-EA85-4bcb-B1FD-5FF0130DEB48")]
public partial class DiagnoseDataList : UserControl
{
}
生成的dll放入web项目bin目录
在HTML中如下调用
<param name="BrowserVersion" id="BrowserVersion" value="<%=this.GetBrowserVersion() %>" />
<param name="MajorVersion" id="MajorVersion" value="<%=this.GetBrowserMajorVersion() %>" />
<param name="BrowserVersionType" id="BrowserVersionType" value="<%=this.GetBrowserVersionType() %>" />
<param name="WebServiceUrl" id="WebServiceUrl" value="<%=this.GetWebServiceUrl() %>" />
<param name="DownLoadFile" id="DownLoadFile" value="<%=this.GetDownLoadFile() %>" />
<param name="UpLoadFile" id="UpLoadFile" value="<%=this.GetUplLoadFile() %>" />
<param name="SiteID" id="SiteID" value="<%=this.GetSiteID() %>" />
<param name="LanguageXML" id="LanguageXML" value="<%=this.GetActiveLanguage() %>" />
</object>
通过param把相关的属性传入object组件
但是发布后出现了问题,每当关闭浏览器,都会不断弹出如下对话框
而且经测试,弹出次数与组件内控件的数量成正比。
网上查找后,有文章说是由于ActiveX组件资源未释放,然后给出如下代码
{
if (disposing && (components != null))
{
components.Dispose();
}
base.Dispose(disposing);
}
但是这代码是在创建的时候自动生成的,应该不会有问题啊。
我突然想到,难道页面关闭未触发Dispose方法?
于是我在组件中写了如下方法,手动调用
{
this.Dispose();
}
然而在HTML中调用又出了问题,在button中直接写在onclick事件中是可以的
先点击释放了组件再关闭页面是有效的,但是总不能让客户每次关浏览器都要先点下button吧,这是不现实的
然后经过网上查找,找到了如下方法
用javascript重新定义 window.onbeforeunload() 事件
{
CheckClientConfig.CloseControl();
}
这个方法很好,无论是直接“ALT+F4”关闭,还是直接点右上角的关闭按钮,都能捕捉到。(这个问题是我一直想解决的,终于被我找到了,嘿嘿)
然而,直接这样调用JS会报CheckClientConfig未定义的错误,和直接写在button中不一样,这里会报错,报着试试看的心里测试了下如下代码
{
var obj = window.document.getElementById("CheckClientConfig");
if (obj)
{
obj.CloseControl();
}
}
居然成功了,不可思议,如果哪位老大知道什么原因,请指教一二。
最后功能实现,嘿嘿