最近做讀卡器的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的選項。