C# ActiveX控件开发,打包cab安装部署,含源码及全过程开发文档

1. 问题场景

在C/S架构的系统中，客户端要实现某些业务功能，可以通过安装相关的应用程序集来方便的实现。同样的需求，在B/S架构的系统里实现起来却比较困难。因为所有的程序都放在服务器端，客户端只是采用浏览器，通过HTTP协议来访问服务器端。比较成熟的解决办法是开发ActiveX控件安装到客户端，这样客户端的浏览器就可以访问本地的ActiveX控件来执行相关的本地操作。通常开发ActiveX使用C，C++或VB开发，本文将要谈论的，就是使用C#开发一个ActiveX控件。

3. 注意的地方，C#开发的ActiveX控件只可在装有Framework的系统上才能用。

2. 开发工具

Visual Studio 2010

.NET版本：2.0

开发语言：C#

3. ActiveX控件项目创建

(1)， 新建一个【Windows窗体控件库项目】，项目名为ActiveXDemo

选择.NET Framwork2.0版本，因为.Net2.0安装文件只有20多M，客户端容易接受，而且如今多数家用电脑都装了.Net2.0

(2)，需要更改两个地方的设置，选中刚创建的ActiveXDemo项目：

1).右键选择“属性 >> 应用程序 >> 程序集信息”设置，勾选“使程序集 COM 可见”：

2). 右键选择“属性 >> 应用程序 >> 生成”设置，勾选“为COM 互操作注册”（注意，此处如果是在debug状态下修改的，那么在调到release状态下还需要再设置一次）：

4. ActiveX控件功能添加

(1)，添加一个用户控件

(2)，为了使该用户控件作为一个ActiveX控件进行使用，还需要做以下修改：

首先，为控件类添加GUID，这个编号将用于B/S系统的客户端调用时使用（可以使用 工具-创建GUID 菜单创建一个GUID）：

[Guid("DF0769A5-99D3-4BE0-90B8-91C65A92118C"), ProgId(""), ComVisible(true)]

public partial class MiugoX : UserControl, IObjectSafety

{

„„

// DF0769A5-99D3-4BE0-90B8-91C65A92118C就¨ª是º?刚?刚?创ä¡ä建¡§的Ì?Guid

(3)，为了让ActiveX控件获得客户端的信任，控件类还需要实现一个名为“IObjectSafety”的接口。先创建该接口（注意，不能修改该接口的GUID值）：添加一个接口IObjectSafety，实现该接口的目的就是提高程序的安全性，以便客户端IE在不更改设置的情况下可以预行该ActiveX控件。接口成员如下：

using System;

using pServices;

namespace ActiveXDemo

{

[ComImport, GuidAttribute("CB5BDC81-93C1-11CF-8F20-00805F2CD064")]

[InterfaceTypeAttribute(aceIsIUnknown)]

public interface IObjectSafety

{

[PreserveSig]

int GetInterfaceSafetyOptions(ref Guid riid, [MarshalAs(UnmanagedType.U4)] ref int

pdwSupportedOptions, [MarshalAs(UnmanagedType.U4)] ref int pdwEnabledOptions);

[PreserveSig()]

int SetInterfaceSafetyOptions(ref Guid riid, [MarshalAs(UnmanagedType.U4)] int dwOptionSetMask,

[MarshalAs(UnmanagedType.U4)] int dwEnabledOptions);

}

}

(4)，用户控件需要继承并实现IObjectSafety接口，需要引用using graphy和using pServices;两个命名空间

实现的接口成员如下：

using System;

using entModel;

using g;

using ;

using ;

using ;

using graphy;

using pServices;

namespace ActiveXDemo

{

[Guid("DF0769A5-99D3-4BE0-90B8-91C65A92118C"), ProgId(""),

ComVisible(true)]

public partial class MiugoX : UserControl, IObjectSafety

{

#region IObjectSafety 成员

private const string _IID_IDispatch = "{00020400-0000-0000-C0046}";

private const string _IID_IDispatchEx = "{a6ef9860-c720-11d0-9337-00a0c90dcaa9}";

private const string _IID_IPersistStorage = "{0000010A-0000-0000-C0046}";

private const string _IID_IPersistStream = "{00000109-0000-0000-C0046}";

private const string _IID_IPersistPropertyBag = "{37D84F60-42CB-11CE-8135-00AA004BB851}";

private const int INTERFACESAFE_FOR_UNTRUSTED_CALLER = 0x00000001;

private const int INTERFACESAFE_FOR_UNTRUSTED_DATA = 0x00000002;

private const int S_OK = 0;

private const int E_FAIL = unchecked((int)0x80004005);

private const int E_NOINTERFACE = unchecked((int)0x80004002);

private bool _fSafeForScripting = true;

private bool _fSafeForInitializing = true;

public int GetInterfaceSafetyOptions(ref Guid riid, ref int pdwSupportedOptions, ref int

pdwEnabledOptions)

{

int Rslt = E_FAIL;

string strGUID = ng("B");

pdwSupportedOptions = INTERFACESAFE_FOR_UNTRUSTED_CALLER |

INTERFACESAFE_FOR_UNTRUSTED_DATA;

switch (strGUID)

{

case _IID_IDispatch:

case _IID_IDispatchEx:

Rslt = S_OK;

pdwEnabledOptions = 0;

if (_fSafeForScripting == true)

pdwEnabledOptions = INTERFACESAFE_FOR_UNTRUSTED_CALLER;

break;

case _IID_IPersistStorage:

case _IID_IPersistStream:

case _IID_IPersistPropertyBag:

Rslt = S_OK;

pdwEnabledOptions = 0;

if (_fSafeForInitializing == true)

pdwEnabledOptions = INTERFACESAFE_FOR_UNTRUSTED_DATA;

break;

default:

Rslt = E_NOINTERFACE;

break;

}

return Rslt;

}

public int SetInterfaceSafetyOptions(ref Guid riid, int dwOptionSetMask, int dwEnabledOptions)

{

int Rslt = E_FAIL;

string strGUID = ng("B");

switch (strGUID)

{

case _IID_IDispatch:

case _IID_IDispatchEx:

if (((dwEnabledOptions & dwOptionSetMask) ==

INTERFACESAFE_FOR_UNTRUSTED_CALLER) &&

(_fSafeForScripting == true))

Rslt = S_OK;

break;

case _IID_IPersistStorage:

case _IID_IPersistStream:

case _IID_IPersistPropertyBag:

if (((dwEnabledOptions & dwOptionSetMask) ==

INTERFACESAFE_FOR_UNTRUSTED_DATA) &&

(_fSafeForInitializing == true))

Rslt = S_OK;

break;

default:

Rslt = E_NOINTERFACE;

break;

}

return Rslt;

}

#endregion

}

}

(5)，按照开发Windows用户控件一样的思路完成该控件的开发，本例中主要实现了三个业务功能，第一是创建文件，第二是获取某目录下的文件，第三是显示“你好，ActiveX”的提示消息。用户控件设计界面：

程序功能代码：

using System;

using entModel;

using g;

using ;

using ;

using ;

using graphy;

using pServices;

namespace ActiveXDemo

{

[Guid("DF0769A5-99D3-4BE0-90B8-91C65A92118C"), ProgId(""), ComVisible(true)]

public partial class MiugoX : UserControl, IObjectSafety

{

#region IObjectSafety 成员

//…IObjectSafety 成员代码省略，请参考第(4)段

#endregion

public MiugoX()

{

InitializeComponent();

= "";

}

public void SayHelloWord()

{

("你好 ActiveX !");

}

public void ShowMessage(string msg)

{

(msg);

}

public string GetHelloWord()

{

return "Hello ActiveX";

}

public void CreateText()

{

= "";

if ( == "")

{

= "请输入文件名?";

return;

}

string dir = "C:ActiveDemo";

string filePath = dir + "" + + ".txt";

if (!(dir))

{

Directory(dir);

}

if (!(filePath))

{

Text(filePath);

+= filePath + "创建成功rn";

}

else

{

+= filePath + "已存在";

}

}

public void GetFiles()

{

string dir = "C:ActiveDemo";

if (!(dir))

{

Directory(dir);

}

string[] fileNameList = es(dir);

if ( == 0)

{

= "没有文件";

return;

}

StringBuilder sb = new StringBuilder();

foreach (string fileName in fileNameList)

{

(fileName + "rn");

}

= "";

= ng();

}

private void btnCreateFile_Click(object sender, EventArgs e)

{

CreateText();

}

private void btnGetFiles_Click(object sender, EventArgs e)

{

GetFiles();

}

}

}

(6)，到这一步，一个简单的ActiveX控件已开发完成。

X控件调试

建立一个Web应用程序项目，在测试页面的html或aspx页面代码中添加对ActiveX控件的引用，并且可以通过Javascript调用控件的公共成员（注意这里clsid后面的值即为前面为用户控件类设置的GUID）：

6. ActiveX控件部署和升级

ActiveX控件可以使用Visual Studio 2010的安装项目进行部署。这与普通的Windows Form应用程序的部署几乎一样，只有一个地方需要注意，将前面创建的用户控件项目作为主输出项目，并设置其Register属性为vsdrpCOM，其布署和升级的详细文档请看下一篇介绍。

7. 总结

综上所述，在Visual Studio 2010环境中使用C#开发ActiveX控件，技术实现上没有什么难度，唯一的问题就是客户端需要安装.NET Framework。鉴于ActiveX控件一般都是实现一些简单单一的功能，.NET

Framework 2.0已经完全可以应付，所以建议在.NET Framework 2.0下开发。因为相对于.NET Framework

3.5或4.0两百多兆的安装包，.NET Framework 2.0安装包只有20多兆，用户相对容易接受一些。