smtpserverhelper.cs

c#常用类库大全

using System;
using System.Text;
using System.IO;
using System.Net.Sockets;
using System.Collections;

public enum MailFormat { Text, HTML };
public enum MailPriority { Low = 1, Normal = 3, High = 5 };

/// <summary>
/// 添加附件
/// </summary>
public class MailAttachments
{
    #region 构造函数
    public MailAttachments()
    {
        _Attachments = new ArrayList();
    }
    #endregion

    #region 私有字段
    private IList _Attachments;
    private const int MaxAttachmentNum = 10;
    #endregion

    #region 索引器
    public string this[int index]
    {
        get { return (string)_Attachments[index]; }
    }
    #endregion

    #region 公共方法
    /// <summary>
    /// 添加邮件附件
    /// </summary>
    /// <param name="FilePath">附件的绝对路径</param>
    public void Add(params string[] filePath)
    {
        if (filePath == null)
        {
            throw (new ArgumentNullException("非法的附件"));
        }
        else
        {
            for (int i = 0; i < filePath.Length; i++)
            {
                Add(filePath[i]);
            }
        }
    }

    /// <summary>
    /// 添加一个附件,当指定的附件不存在时，忽略该附件，不产生异常。
    /// </summary>
    /// <param name="filePath">附件的绝对路径</param>
    public void Add(string filePath)
    {
        if (System.IO.File.Exists(filePath))
        {
            if (_Attachments.Count < MaxAttachmentNum)
            {
                _Attachments.Add(filePath);
            }
        }
    }

    /// <summary>
    /// 清除所有附件
    /// </summary>
    public void Clear()
    {
        _Attachments.Clear();
    }

    /// <summary>
    /// 获取附件个数
    /// </summary>
    public int Count
    {
        get { return _Attachments.Count; }
    }
    #endregion
}

/// <summary>
/// 邮件信息
/// </summary>
public class MailMessage
{        
    #region 构造函数
    public MailMessage()
    {
        _Recipients = new ArrayList();        //收件人列表
        _Attachments = new MailAttachments(); //附件
        _BodyFormat = MailFormat.HTML;        //缺省的邮件格式为HTML
        _Priority = MailPriority.Normal;
        _Charset = "GB2312";
    }
    #endregion

    #region 私有字段
    private int _MaxRecipientNum = 30;
    private string _From;      //发件人地址
    private string _FromName;  //发件人姓名
    private IList _Recipients; //收件人
    private MailAttachments _Attachments;//附件
    private string _Body;      //内容
    private string _Subject;   //主题
    private MailFormat _BodyFormat;     //邮件格式
    private string _Charset = "GB2312"; //字符编码格式
    private MailPriority _Priority;     //邮件优先级
    #endregion

    #region 公有属性
    /// <summary>
    /// 设定语言代码，默认设定为GB2312，如不需要可设置为""
    /// </summary>
    public string Charset
    {
        get { return _Charset; }
        set { _Charset = value; }
    }

    /// <summary>
    /// 最大收件人
    /// </summary>
    public int MaxRecipientNum
    {
        get { return _MaxRecipientNum; }
        set { _MaxRecipientNum = value; }
    }

    /// <summary>
    /// 发件人地址
    /// </summary>
    public string From
    {
        get { return _From; }
        set { _From = value; }
    }

    /// <summary>
    /// 发件人姓名
    /// </summary>
    public string FromName
    {
        get { return _FromName; }
        set { _FromName = value; }
    }

    /// <summary>
    /// 内容
    /// </summary>
    public string Body
    {
        get { return _Body; }
        set { _Body = value; }
    }

    /// <summary>
    /// 主题
    /// </summary>
    public string Subject
    {
        get { return _Subject; }
        set { _Subject = value; }
    }

    /// <summary>
    /// 附件
    /// </summary>
    public MailAttachments Attachments
    {
        get { return _Attachments; }
        set { _Attachments = value; }
    }

    /// <summary>
    /// 优先权
    /// </summary>
    public MailPriority Priority
    {
        get { return _Priority; }
        set { _Priority = value; }
    }

    /// <summary>
    /// 收件人
    /// </summary>
    public IList Recipients
    {
        get { return _Recipients; }
    }

    /// <summary>
    /// 邮件格式
    /// </summary>
    public MailFormat BodyFormat
    {
        set { _BodyFormat = value; }
        get { return _BodyFormat; }
    }
    #endregion

    #region 公共方法
    /// <summary>
    /// 增加一个收件人地址
    /// </summary>
    /// <param name="recipient">收件人的Email地址</param>
    public void AddRecipients(string recipient)
    {
        if (_Recipients.Count < MaxRecipientNum)
        {
            _Recipients.Add(recipient);
        }
    }

    /// <summary>
    /// 增加多个收件人地址
    /// </summary>
    /// <param name="recipient">收件人的Email地址集合</param>
    public void AddRecipients(params string[] recipient)
    {
        if (recipient == null)
        {
            throw (new ArgumentException("收件人不能为空."));
        }
        else
        {
            for (int i = 0; i < recipient.Length; i++)
            {
                AddRecipients(recipient[i]);
            }
        }
    }
    #endregion
}

/// <summary>
/// 邮件操作
/// </summary>
public class SmtpServerHelper
{
    #region 构造函数、析构函数
    public SmtpServerHelper()
    {
        SMTPCodeAdd();
    }

    ~SmtpServerHelper()
    {
        networkStream.Close();
        tcpClient.Close();
    }
    #endregion

    #region 私有字段
    /// <summary>
    /// 回车换行
    /// </summary>
    private string CRLF = "\r\n";

    /// <summary>
    /// 错误消息反馈
    /// </summary>
    private string errmsg;

    /// <summary>
    /// TcpClient对象，用于连接服务器
    /// </summary> 
    private TcpClient tcpClient;

    /// <summary>
    /// NetworkStream对象
    /// </summary> 
    private NetworkStream networkStream;

    /// <summary>
    /// 服务器交互记录
    /// </summary>
    private string logs = "";

    /// <summary>
    /// SMTP错误代码哈希表
    /// </summary>
    private Hashtable ErrCodeHT = new Hashtable();

    /// <summary>
    /// SMTP正确代码哈希表
    /// </summary>
    private Hashtable RightCodeHT = new Hashtable();
    #endregion
    
    #region 公有属性
    /// <summary>
    /// 错误消息反馈
    /// </summary>
    public string ErrMsg
    {
        set { errmsg = value; }
        get { return errmsg; }
    }
    #endregion

    #region 私有方法
    /// <summary>
    /// 将字符串编码为Base64字符串
    /// </summary>
    /// <param name="str">要编码的字符串</param>
    private string Base64Encode(string str)
    {
        byte[] barray;
        barray = Encoding.Default.GetBytes(str);
        return Convert.ToBase64String(barray);
    }

    /// <summary>
    /// 将Base64字符串解码为普通字符串
    /// </summary>
    /// <param name="str">要解码的字符串</param>
    private string Base64Decode(string str)
    {
        byte[] barray;
        barray = Convert.FromBase64String(str);
        return Encoding.Default.GetString(barray);
    }

    /// <summary>
    /// 得到上传附件的文件流
    /// </summary>
    /// <param name="FilePath">附件的绝对路径</param>
    private string GetStream(string FilePath)
    {
        System.IO.FileStream FileStr = new System.IO.FileStream(FilePath, System.IO.FileMode.Open);
        byte[] by = new byte[System.Convert.ToInt32(FileStr.Length)];
        FileStr.Read(by, 0, by.Length);
        FileStr.Close();
        return (System.Convert.ToBase64String(by));
    }

    /// <summary>
    /// SMTP回应代码哈希表
    /// </summary>
    private void SMTPCodeAdd()
    {
        ErrCodeHT.Add("421", "服务未就绪，关闭传输信道");
        ErrCodeHT.Add("432", "需要一个密码转换");
        ErrCodeHT.Add("450", "要求的邮件操作未完成，邮箱不可用（例如，邮箱忙）");
        ErrCodeHT.Add("451", "放弃要求的操作；处理过程中出错");
        ErrCodeHT.Add("452", "系统存储不足，要求的操作未执行");
        ErrCodeHT.Add("454", "临时认证失败");
        ErrCodeHT.Add("500", "邮箱地址错误");
        ErrCodeHT.Add("501", "参数格式错误");
        ErrCodeHT.Add("502", "命令不可实现");
        ErrCodeHT.Add("503", "服务器需要SMTP验证");
        ErrCodeHT.Add("504", "命令参数不可实现");
        ErrCodeHT.Add("530", "需要认证");
        ErrCodeHT.Add("534", "认证机制过于简单");
        ErrCodeHT.Add("538", "当前请求的认证机制需要加密");
        ErrCodeHT.Add("550", "要求的邮件操作未完成，邮箱不可用（例如，邮箱未找到，或不可访问）");
        ErrCodeHT.Add("551", "用户非本地，请尝试<forward-path>");
        ErrCodeHT.Add("552", "过量的存储分配，要求的操作未执行");
        ErrCodeHT.Add("553", "邮箱名不可用，要求的操作未执行（例如邮箱格式错误）");
        ErrCodeHT.Add("554", "传输失败");

        RightCodeHT.Add("220", "服务就绪");
        RightCodeHT.Add("221", "服务关闭传输信道");
        RightCodeHT.Add("235", "验证成功");
        RightCodeHT.Add("250", "要求的邮件操作完成");
        RightCodeHT.Add("251", "非本地用户，将转发向<forward-path>");
        RightCodeHT.Add("334", "服务器响应验证Base64字符串");
        RightCodeHT.Add("354", "开始邮件输入，以<CRLF>.<CRLF>结束");
    }

    /// <summary>
    /// 发送SMTP命令
    /// </summary> 
    private bool SendCommand(string str)
    {
        byte[] WriteBuffer;
        if (str == null || str.Trim() == String.Empty)
        {
            return true;
        }
        logs += str;
        WriteBuffer = Encoding.Default.GetBytes(str);
        try
        {
            networkStream.Write(WriteBuffer, 0, WriteBuffer.Length);
        }
        catch
        {
            errmsg = "网络连接错误";
            return false;
        }
        return true;
    }

    /// <summary>
    /// 接收SMTP服务器回应
    /// </summary>
    private string RecvResponse()
    {
        int StreamSize;
        string Returnvalue = String.Empty;
        byte[] ReadBuffer = new byte[1024];
        try
        {
            StreamSize = networkStream.Read(ReadBuffer, 0, ReadBuffer.Length);
        }
        catch
        {
            errmsg = "网络连接错误";
            return "false";
        }

        if (StreamSize == 0)
        {
            return Returnvalue;
        }
        else
        {
            Returnvalue = Encoding.Default.GetString(ReadBuffer).Substring(0, StreamSize);
            logs += Returnvalue + this.CRLF;
            return Returnvalue;
        }
    }

    /// <summary>
    /// 与服务器交互，发送一条命令并接收回应。
    /// </summary>
    /// <param name="str">一个要发送的命令</param>
    /// <param name="errstr">如果错误，要反馈的信息</param>
    private bool Dialog(string str, string errstr)
    {
        if (str == null || str.Trim() == string.Empty)
        {
            return true;
        }
        if (SendCommand(str))
        {
            string RR = RecvResponse();
            if (RR == "false")
            {
                return false;
            }

            //检查返回的代码，根据[RFC 821]返回代码为3位数字代码如220
            string RRCode = RR.Substring(0, 3);
            if (RightCodeHT[RRCode] != null)
            {
                return true;
            }
            else
            {
                if (ErrCodeHT[RRCode] != null)
                {
                    errmsg += (RRCode + ErrCodeHT[RRCode].ToString());
                    errmsg += CRLF;
                }
                else