使用VS2010 C#開發ActiveX控件

最近做讀卡器的B/S應用程序開發,由於讀卡器廠商提供的手冊都是C/S版本的,而且只有一個原始的Dll包,並沒有web版的,那麼就只好自己動手,豐衣足食了。
         要開發Web版的讀卡程序,大體思路如下:

1.       使用C#對原始的Dll進行封裝,這裏要封裝兩部分內容,一部分是串口通信的功能,一部分是對卡讀寫的功能。

2.       開發ActiveX控件調用封裝後的Dll,使用串口通信來對卡進行讀寫。

3.       打包併發布ActiveX控件。

4.  使用ActiveX控件。

思路1中封裝代碼有2個類SerialInterfaceHelper,串口通信的幫助類,MifareOneHelper,M1卡的讀寫幫助類,我們放在了項目CardReader.Library中。

由於本文的重點是使用VS 2010(C#)進行ActiveX控件的開發,因此思路1中的內容就不進行詳述了,後面會直接給出類庫可以參考。本文的實例中演示C#開發

一個ActiveX讀卡器控件,實現讀取卡號並顯示出卡號或異常信息的功能,分成三個大的步驟來實現:開發ActiveX控件、打包併發布ActiveX控件和使用

ActiveX控件。

   開發ActiveX控件
     常見的一些ActiveX大部分是使用VB、Delphi、C++開發,使用C#開發ActiveX要解決下面三個問題:
(1)使.NET組件可以被COM調用
(2)在客戶機上註冊後,ActiveX控件能通過IE的安全認證 
(3)已在客戶機上註冊時,安裝包能通過IE的簽名認證
開發ActiveX步驟:
1. 創建Windows Forms Control Library項目CardReader.Controls,設置項目屬性能夠被COM調用。
右擊CardReader.Controls,選擇屬性,設置項目的Assembly屬性,如下圖1所示:

 

圖1 
對Make Assembly Com-Visible選項劃鉤。
設置項目的編譯選項,如圖2所示:

圖2
圖2中對Register for COM Interop選中,對COM組件進行註冊。(注意,此處如果實在debug狀態下修改的,那在調到release狀態下還需要再設置一次。)

設置應用程序的AssemblyInfo屬性,右擊項目的Properties,打開AssemblyInfo文件,Assembly:AllowPartiallyTrustedCallers,注意添加引用System.Security,代碼如下:

using System.Reflection;

using System.Runtime.CompilerServices;

using System.Runtime.InteropServices;

using System.Security;

// General Information about an assembly is controlled through the following 

// set of attributes. Change these attribute values to modify the information

// associated with an assembly.

[assembly: AssemblyTitle("CardReader.Controls")]

[assembly: AssemblyDescription("")]

[assembly: AssemblyConfiguration("")]

[assembly: AssemblyCompany("Microsoft")]

[assembly: AssemblyProduct("CardReader.Controls")]

[assembly: AssemblyCopyright("Copyright © Microsoft 2011")]

[assembly: AssemblyTrademark("")]

[assembly: AssemblyCulture("")]

 

[assembly:AllowPartiallyTrustedCallers()]

// Setting ComVisible to false makes the types in this assembly not visible 

// to COM components.  If you need to access a type in this assembly from 

// COM, set the ComVisible attribute to true on that type.

[assembly: ComVisible(true)]

 

// The following GUID is for the ID of the typelib if this project is exposed to COM

[assembly: Guid("15493d85-ec9e-4c75-a237-9009a997b780")]

 

// Version information for an assembly consists of the following four values:

//

//      Major Version

//      Minor Version 

//      Build Number

//      Revision

//

// You can specify all the values or you can default the Build and Revision Numbers 

// by using the '*' as shown below:

// [assembly: AssemblyVersion("1.0.*")]

[assembly: AssemblyVersion("1.0.0.0")]

[assembly: AssemblyFileVersion("1.0.0.0")]

 


 
2. 開發讀卡器用戶控件,這個用戶控件包含三個部分:
一個TextBox,用以顯示讀出的卡號
一個Button,讀卡
一個Label,顯示錯誤信息
編寫讀卡按鈕事件的代碼,完成控件開發後,爲了使該用戶控件作爲一個ActiveX控件進行使用,還需要做以下修改:

首先,爲控件類創建一個唯一的GUID,這個編號將用於B/S系統的客戶端調用時使用,注意這裏的GUID不能和AssemblyInf中的GUID相同,生成GUID的方法如下,

在開始-》程序中打開Microsoft Windows SDK Tools,如下圖3所示: 

 

 

 

圖3

點擊GUID Generator,生成GUID,如下圖4所示:

 

圖4

COPY生成的GUID到記事本,再拷貝GUID的字符串到控件類,代碼如下所示:[Guid("E395359C-86F2-4D7B-A91A-5A64B9E3BA6C")]
public partial class ReadCardControl : UserControl

其次,爲了讓ActiveX控件獲得客戶端的信任,控件類還需要實現一個名爲“IObjectSafety”的接口,要創建該接口(注意,不能修改該接口的GUID值),
IObjectSafety代碼如下:

    [ComImport, Guid("1D9AD540-F2C9-4368-8697-C4AAFCCE9C55")]
    [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
    public interface IObjectSafety
    {
        [PreserveSig]
        void GetInterfacceSafyOptions(
        int riid,
        out int pdwSupportedOptions,
        out int pdwEnabledOptions);
 
        [PreserveSig]
        void SetInterfaceSafetyOptions(
        int riid,
        int dwOptionsSetMask,
        int dwEnabledOptions);
    }

注意這裏要添加引用:using System.Runtime.InteropServices;

 
3. 修改控件類,使之繼承IObjectSafety接口,代碼清單如下:

[Guid("E395359C-86F2-4D7B-A91A-5A64B9E3BA6C")]
    public partial class ReadCardControl : UserControl,IObjectSafety
    {
        public int icdev; // 通訊設備標識符
        public Int16 st;
        public int sec;
 
        public ReadCardControl()
        {
            InitializeComponent();
        }
        #region IObjectSafety 成員
 
        public void GetInterfacceSafyOptions(int riid, out int pdwSupportedOptions, out int pdwEnabledOptions)
        {
            pdwSupportedOptions = 1;
            pdwEnabledOptions = 2;
        }
 
        public void SetInterfaceSafetyOptions(int riid, int dwOptionsSetMask, int dwEnabledOptions)
        {
            throw new NotImplementedException();
        }
 
        #endregion
}


 
   打包併發布ActiveX

         ActiveX控件開發完成後,我們要講ActiveX控件打包和發佈。ActiveX控件可以使用VS 2010的安裝項目進行部署,使用VS 2010創建Windows Form的安裝工程就可以將ActiveX的dll進行打包。在打包時注意將ActiveX控件項目作爲主輸出項目,並設置其Register屬性爲vsdrpCOM,創建打包項目如下圖5所示:


圖5
創建一個Windows 安裝項目,並給項目添加項目輸出,如下圖6所示:

圖6
在添加項目輸出時,我們將ActiveX項目添加進來,在項目中選擇ActiveX控件項目(CardReader.Controls),Primary Out(基本輸出),如下圖7所示:

圖7

添加完項目輸出以後,在Application Folder裏已經有了三個文件:CardReader.Controls.tlb、CardReader.Libary.dll、Primary Output From CardReader.Controls,同時將mwrf32.dll也打進安裝包裏,右擊添加文件,瀏覽到mwrf32.dll添加進來即可。注意首先要將mwrf32.dll拷貝到ActiveX控件

項目中的Bin中,添加文件時瀏覽到\\CardReader\CardReader.Controls\bin\Debug中的mwrf32.dll打包進去,否則會出現找不到mwrf32.dll的錯誤。

添加完文件後,設置Primary Output From CardReader.Controls的Register屬性爲vsdrpCOM。設置完成後右擊安裝工程SetupCardReader,

修改其屬性,如下圖8所示:


 圖8

         在上圖中可以設置輸出的文件名,這個文件名就是打包後安裝文件.MSI的文件名。設置包文件、壓縮方式,CAB size,這三項均選擇默認值即可。

最後設置安裝URL,這裏的安裝URL是用來發布或者測試ActiveX的URL地址的。上圖中我們將在89端口下進行測試,因此URL設置爲:

http://localhost:89/CardReader

這樣打包文件就生成了,我們可以打開\\CardReader\SetupCardReader\Debug看到生成了2個文件,一個是setup.exe,一個是SetupCardReader.msi,

這裏的Setup.exe就是我們在使用ActiveX時的codebase文件。

打包成exe文件以後,我們可以進一步對安裝文件進行打包成.cab文件,安裝隱藏了msi 安裝界面,類似於cabarc 打包ocx 的效果

(點擊install 之後其他的都後臺做了),本文中暫不討論,感興趣的讀者可以使用CAB SDK 中的工具CABARC.EXE (下載地址 http://support.microsoft.com/kb/310618 )來進行。

   使用ActiveX
打包完成後,我們就可以在應用程序中使用打包好的ActiveX控件了,創建一個web項目(CardReader.Web),在測試頁面的HTML代碼中添加對ActiveX控件
的引用,修改default.aspx的代碼如下:

    <object id="cardReader1" classid="clsid:E395359C-86F2-4D7B-A91A-5A64B9E3BA6C" 
        width="500"
        height="100" 
        codebase="CardReader/SetupCardReader/Debug/Setup.exe">
    </object>

注意這裏的clsid:E395359C-86F2-4D7B-A91A-5A64B9E3BA6C的值是我們在開發ActiveX控件時的GUID。
運行的效果圖下圖9所示:

 

 圖9

         圖9中,我們演示了不調用串口通信和讀卡程序下的效果,至於要調用串口通信和讀卡程序,我將在另一篇帖子裏進行詳細說明。

         至此,使用VS 2010開發ActiveX控件的大部分功能已經完成了,在VS 2010環境中使用C#開發ActiveX控件,技術並不太困難,但是要求客戶端需要安裝.NET Framework。鑑於ActiveX控件一般都是實現一些簡單單一的功能,所以建議使用.NET Framework 2.0/.NET Framework 4.0下開發,

本實例中我們使用了.NET Framework 4.0。

 

以上我們介紹了開發、打包、發佈、使用ActiveX控件的全過程。在演示程序中,我們沒有調用串口通信和讀卡器Dll程序,由於我們讀卡器的原始Dll是使用其它語言進行開發的,對C#來說,是非託管代碼,因此我們還需要在代碼級別進行非託管代碼的安全性設置。

 

 其實如果我們不進行設置,只是修改了代碼,運行程序以後,其出錯界面如下圖1所示:

 

圖1

拋出異常如下:

************** Exception Text **************

System.MethodAccessException: Attempt by security transparent method 'Rare.Card.Libary.Controls.

ReadCardControl.btnRead_Click(System.Object, System.EventArgs)' to call native code through method 'Rare.Card.Libary.MifareOneHelper.rf_read(Int32, Int32, Byte[])' failed. Methods must be security critical or

security safe-critical to call native code.

 

通過查閱MSDN,對異常的解釋如下:

在 Microsoft .NET Framework 4 中,公共語言運行時 (CLR) 安全模型發生了不少變化。其中一項變化,即採用 Level2 透明性

(與 Silverlight 的安全模型非常相似)很可能影響 AllowPartiallyTrustedCallers (APTCA) 庫的作者。透明性屬性有三種:SecurityTransparent、SecuritySafeCritical 和 SecurityCritical。

 

SecurityTransparent:標記爲 SecurityTransparent 的代碼從安全性角度而言是可靠的。它不能完成任何危險操作,例如聲明權限、

執行無法驗證的代碼或調用本機代碼。它也不能直接調用 SecurityCritical 代碼。

如上文所述,出於安全的考慮,所有部分受信任代碼都強制爲 SecurityTransparent。這也是 APTCA 庫的默認透明性。

SecurityCritical:與 SecurityTransparent 不同,SecurityCritical 代碼能夠執行任何所需操作。它能夠執行聲明、

調用本機代碼和其他操作。它能夠調用其他方法,且不受透明性標記的限制。

只有完全受信任代碼才能爲 SecurityCritical。事實上,(非 APTCA)完全受信任代碼默認情況下屬於 SecurityCritical,

從而保護其免受透明的部分受信任調用方的調用。

SecuritySafeCritical:SecuritySafeCritical 代碼起着橋樑的作用,它允許透明代碼調用關鍵方法。SecuritySafeCritical

代碼與 SecurityCritical 代碼的權限相同,但它可由 SecurityTransparent 代碼調用。因此,SecuritySafeCritical 代碼必須以安全方式公開基礎 SecurityCritical 方法(以避免一些部分受信任的惡意代碼嘗試通過 SecuritySafeCritical 層攻擊這些方法),這一點極爲重要。

與 SecurityCritical 代碼一樣,SecuritySafeCritical 代碼必須完全受信任。

具體可以參考:

http://msdn.microsoft.com/zh-cn/magazine/ee336023.aspx

 

根據MSDN的解釋,問題出在了封裝原始Dll的C#類庫CardReader.Library上,我們可以在代碼級別設置透明性屬性可以解決問題。

具體解決辦法如下:

1.       設置ActiveX控件讀卡代碼的透明屬性爲:SecuritySafeCritical,設置以後的代碼清單如下:

       [SecuritySafeCritical]

        /// <summary>

        /// 讀卡

        /// </summary>

        /// <param name="sender"></param>

        /// <param name="e"></param>

        private void btnRead_Click(object sender, EventArgs e)

        {

            int i = 0;

            byte[] data = new byte[16];

            byte[] buff = new byte[32];

 

            for (i = 0; i < 16; i++)

                data[i] = 0;

            for (i = 0; i < 32; i++)

                buff[i] = 0;

 

            st = MifareOneHelper.rf_read(icdev, sec * 4 + 1, data);

            if (st == 0)

            {

                SerialInterfaceHelper.hex_a(data, buff, 16);

                txtCardID.Text = System.Text.Encoding.ASCII.GetString(buff);

                lblMsg.Text = "讀取卡號成功!";

            }

            else

                lblMsg.Text = "讀取卡號失敗!";

 

            //test method

            //if (string.IsNullOrEmpty(txtCardID.Text))

            //{

            //    lblMsg.Text = "讀取數據失敗!";

            //}

            //else

            //{

            //    lblMsg.Text = string.Format("讀取數據:{0}!", txtCardID.Text);

            //}

        }
注意要添加引用:using System.Security;

在這裏注掉了測試代碼,使用了串口通信和讀卡代碼。

2. 設置封裝原始讀卡器Dll的透明屬性。

設置M1讀卡器幫助類MifareOneHelper的透明屬性爲:[SecurityCritical],同時設置調用的方法MifareOneHelper.rf_read的

透明屬性爲[SecurityCritical]。

    設置串口通信幫助類SerialInterfaceHelper的透明屬性爲:[SecurityCritical],同時設置調用的方法SerialInterfaceHelper.hex_a的

透明屬性爲[SecurityCritical]。

 

完整代碼已提供,還有2個地方需要注意的是,客戶端如果安裝ActiveX失敗,則把運行ActiveX的地址加入到信任站點裏,

信任站點的安全級別降低到最低或者設置信任站點關於ActiveX的選項。

/Files/yungboy/CardReader.7

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章