一.前言
Visual C#作為一門新興的編程語言,具有許多其它語言無法比擬的優點。它既有VB的快速簡潔,同時又不失C++的高效性能,而且作為一門基於組件編程的語言,它在組件編程方面有著相當強大和完善的功能。本文筆者就通過運用Visual C#編寫一個Pop3郵件接收組件向大家介紹如何用Visual C#進行組件編程以及編程過程中的一些方法和技巧,最後還給出了一個對該Pop3組件進行測試的Windows Forms程序。
二.基本原理
要完成一個Pop3組件,就要完成對該組件的屬性(Property)、方法(Method)和事件(Event)等的設計。屬性是一個組件的重要特征,一個組件一般有多項屬性。我們可以通過get和set取得和設置各個屬性的值。完成了各個屬性的設置,我們可以通過該組件的各種方法進行相應的操作。而事件則是在某些特定的消息下觸發的。在C#中,我們用代表(delegate)進行事件的聲明。
在該Pop3組件中,我們為其添加了主機名(Host)、端口號(Port)、用戶名(UserName)、密碼(PassWord)、郵件數目(NumOfMails)、郵件大小(TotalSize)等屬性,通過ReceiveMessage()和ReceiveMessageAsync()方法完成與服務器的連接、通訊和結束會話等功能,在調用了該方法後,我們就可以從郵件數目和郵件大小等屬性中獲得郵箱中的相關信息,進而運用該組件就可以輕松地開發出諸如郵件信史之類的程序了。同時,該組件中還包含了一個OnMailReceived()事件,該事件在完成了郵件的接收後被觸發。
在組件的設計過程中,與主機的連接通訊是該組件的核心部分,所以我們不妨專門設計一個與主機的連接類-Pop3Connection類,該類是主要運用了TcpClient類的對象,和主機建立基於TCP/IP網絡協議的連接。在完成連接後,可以和主機進行通訊。完成通訊後,則關閉與主機的連接。在大致介紹了實現原理後,下面就是具體的實現方法了。
三.實現方法
首先,打開VS.net,新建一個Visual C#的項目:在項目類型中選擇"Visual C#項目",在模板中選擇"類庫",不妨將該項目命名為"Pop3Com"(這樣,由該項目生成的組件的命名空間就為Pop3Com了),圖示如下:
1.Pop3Connection類:
這樣,項目向導就完成了,接著我們將原來的Class1.cs改名為Pop3.cs,同時添加一個類Pop3Connection(文件名不妨為Pop3Connection.cs)。
如上所述,Pop3Connection類完成了與主機的連接、通訊和關閉連接等功能,所以我們必須調用.Net框架中進行網絡通訊的類庫,在此我們運用的是TcpClient類的對象作為網絡連接的客戶端。同時,在與主機的通訊過程中必然少不了對於輸入輸出流的控制。於是,我們在設計該類的時候,首先得添加如下命名空間:
using System.IO; using System.Net.Sockets; Pop3Connection類的成員變量包括以下幾個: private TcpClient socket; private StreamReader reader; private StreamWriter writer; private bool connected;
其中,bool類型的connected變量用於判斷是否與主機取得了連接,它是該類的一個屬性,對其操作如下:
public bool Connected { get{return connected;} } Pop3Connection類的主要方法包含以下幾個: internal void Open(string host, int port) { if(host == null || host.Trim().Length == 0 || port <= 0) { throw new System.ArgumentException("Invalid Argument found."); } socket.Connect(host, port); reader = new StreamReader(socket.GetStream(), System.Text.Encoding.ASCII); writer = new StreamWriter(socket.GetStream(), System.Text.Encoding.ASCII); connected = true; } internal void SendCommand(string cmd) { writer.WriteLine(cmd); writer.Flush(); } internal void GetReply(out string reply, out int code) { reply = reader.ReadLine(); code = reply == null ? -1 : Int32.Parse(reply.Substring(0, 3)); } internal void Close() { reader.Close(); writer.Flush(); writer.Close(); reader = null; writer = null; socket.Close(); connected = false; }
根據這些方法的名稱,我們不難知道它們的作用。第一個方法Open()就是根據主機名和端口號取得和服務器的連接。一旦連接成功,就通過TcpClient類的對象獲取網絡通訊流並新建一個StreamReader對象和一個StreamWriter對象。不言而喻,這兩個對象的作用是控制網絡通訊的輸出和輸入。最後,還要將connected的屬性設置為true。第二個方法SendCommand()就是在上面的StreamWriter類的對象writer的基礎上往網絡套接字中輸入信息。而第三個方法GetReply()則正好相反,它是用來從網絡套接字中獲取信息的。最後一個方法Close()的作用則是關閉輸出、輸入流的對象,然後調用TcpClient類的對象Close()方法並將connected屬性設置為false,從而關閉連接,結束會話。