C#之FTP上傳下載（二）

這個類幾乎包含了對FTP常用的方法，有不對的地方，歡迎批評指正 

 public class FtpClient
    {
        #region 構造函數
        /// <summary>
        /// 創建FTP工具
        /// <para>
        /// 默認不使用SSL,使用二進制傳輸方式,使用被動模式FTP有兩種使用模式：主動和被動。
        /// 主動模式要求客戶端和服務器端同時打開並且監聽一個端口以建立連接。
        /// 在這種情況下，客戶端由於安裝了防火牆會產生一些問題。
        /// 所以，創立了被動模式。
        /// 被動模式只要求服務器端產生一個監聽相應端口的進程，這樣就可以繞過客戶端安裝了防火牆的問題。
        /// </para>
        /// </summary>
        /// <param name="host">主機名稱</param>
        /// <param name="userId">用戶名</param>
        /// <param name="password">密碼</param>
        public FtpClient(string host, string userId, string password)
            : this(host, userId, password, 21, null, false, true, true)
        {
        }

        /// <summary>
        /// 創建FTP工具
        /// </summary>
        /// <param name="host">主機名稱</param>
        /// <param name="userId">用戶名</param>
        /// <param name="password">密碼</param>
        /// <param name="port">端口</param>
        /// <param name="enableSsl">允許Ssl</param>
        /// <param name="proxy">代理</param>
        /// <param name="useBinary">允許二進制</param>
        /// <param name="usePassive">允許被動模式</param>
        public FtpClient(string host, string userId, string password, int port, IWebProxy proxy, bool enableSsl, bool useBinary, bool usePassive)
        {
            this.userId = userId;
            this.password = password;
            if (host.ToLower().StartsWith("ftp://"))
            {
                this.host = host;
            }
            else
            {
                this.host = "ftp://" + host;
            }
            this.port = port;
            this.proxy = proxy;
            this.enableSsl = enableSsl;
            this.useBinary = useBinary;
            this.usePassive = usePassive;
        }
        #endregion

        #region 變量
        #region 主機
        private string host = string.Empty;
        /// <summary>
        /// 主機
        /// </summary>
        public string Host
        {
            get
            {
                return this.host ?? string.Empty;//如果左操作數為空則返回右操作數，不為空返回左操作數
            }
        }
        #endregion

        #region 登錄用戶名
        private string userId = string.Empty;
        /// <summary>
        /// 登錄用戶名
        /// </summary>
        public string UserId
        {
            get
            {
                return this.userId;
            }
        }
        #endregion

        #region 密碼
        private string password = string.Empty;
        /// <summary>
        /// 密碼
        /// </summary>
        public string Password
        {
            get
            {
                return this.password;
            }
        }
        #endregion

        #region 代理
        IWebProxy proxy = null;
        /// <summary>
        /// 代理
        /// </summary>
        public IWebProxy Proxy
        {
            get
            {
                return this.proxy;
            }
            set
            {
                this.proxy = value;
            }
        }
        #endregion

        #region 端口
        private int port = 21;
        /// <summary>
        /// 端口
        /// </summary>
        public int Port
        {
            get
            {
                return port;
            }
            set
            {
                this.port = value;
            }
        }
        #endregion

        #region 設置是否允許Ssl
        private bool enableSsl = false;
        /// <summary>
        /// EnableSsl 
        /// </summary>
        public bool EnableSsl
        {
            get
            {
                return enableSsl;
            }
        }
        #endregion

        #region 使用被動模式
        private bool usePassive = true;
        /// <summary>
        /// 被動模式
        /// </summary>
        public bool UsePassive
        {
            get
            {
                return usePassive;
            }
            set
            {
                this.usePassive = value;
            }
        }
        #endregion

        #region 二進制方式
        private bool useBinary = true;
        /// <summary>
        /// 二進制方式
        /// </summary>
        public bool UseBinary
        {
            get
            {
                return useBinary;
            }
            set
            {
                this.useBinary = value;
            }
        }
        #endregion

        #region 遠端路徑
        private string remotePath = "/";
        /// <summary>
        /// 遠端路徑
        /// <para>
        ///     返回FTP服務器上的當前路徑(可以是 / 或 /a/../ 的形式)
        /// </para>
        /// </summary>
        public string RemotePath
        {
            get
            {
                return remotePath;
            }
            set
            {
                string result = "/";
                if (!string.IsNullOrEmpty(value) && value != "/")
                {
                    result = "/" + value.TrimStart('/').TrimEnd('/') + "/";
                }
                this.remotePath = result;
            }
        }
        #endregion
        #endregion

        #region 創建一個FTP連接
        /// <summary>
        /// 創建一個FTP請求
        /// </summary>
        /// <param name="url">請求地址</param>
        /// <param name="method">請求方法</param>
        /// <returns>FTP請求</returns>
        private FtpWebRequest CreateRequest(string url, string method)
        {
            //建立連接
            FtpWebRequest request = (FtpWebRequest)FtpWebRequest.Create(new Uri(url));
            request.Credentials = new NetworkCredential(this.userId, this.password);
            request.Proxy = this.proxy;
            request.KeepAlive = false;//命令執行完畢之后關閉連接
            request.UseBinary = useBinary;
            request.UsePassive = usePassive;
            request.EnableSsl = enableSsl;
            request.Method = method;
            return request;

        }
        #endregion

        #region 上傳一個文件到遠端路徑下
        /// <summary>
        /// 把文件上傳到FTP服務器的RemotePath下
        /// </summary>
        /// <param name="localFile">本地文件信息</param>
        /// <param name="remoteFileName">要保存到FTP文件服務器上的文件名稱包含擴展名</param>
        public bool Upload(FileInfo localFile, string remoteFileName)
        {
            bool result = false;
            if (localFile.Exists)
            {
                string url = Host.TrimEnd('/') + RemotePath + remoteFileName;
                FtpWebRequest request = CreateRequest(url, WebRequestMethods.Ftp.UploadFile);

                //上傳數據
                using (Stream rs = request.GetRequestStream())
                using (FileStream fs = localFile.OpenRead())
                {
                    byte[] buffer = new byte[4096];//4K
                    int count = fs.Read(buffer, 0, buffer.Length);//每次從流中讀4個字節再寫入緩沖區
                    while (count > 0)
                    {
                        rs.Write(buffer, 0, count);
                        count = fs.Read(buffer, 0, buffer.Length);
                    }
                    fs.Close();
                    result = true;
                }
                return result;
            }
            throw new Exception(string.Format("本地文件不存在,文件路徑:{0}", localFile.FullName));
        }
        #endregion

        #region 從FTP服務器上下載文件
        /// <summary>
        /// 從當前目錄下下載文件
        /// <para>
        /// 如果本地文件存在,則從本地文件結束的位置開始下載.
        /// </para>
        /// </summary>
        /// <param name="serverName">服務器上的文件名稱</param>
        /// <param name="localName">本地文件名稱</param>
        /// <returns>返回一個值,指示是否下載成功</returns>
        public bool Download(string serverName, string localName)
        {
            bool result = false;
            using (FileStream fs = new FileStream(localName, FileMode.OpenOrCreate)) //創建或打開本地文件
            {
                //建立連接
                string url = Host.TrimEnd('/') + RemotePath + serverName;
                FtpWebRequest request = CreateRequest(url, WebRequestMethods.Ftp.DownloadFile);
                request.ContentOffset = fs.Length;
                using (FtpWebResponse response = (FtpWebResponse)request.GetResponse())
                {
                    fs.Position = fs.Length;
                    byte[] buffer = new byte[4096];//4K
                    int count = response.GetResponseStream().Read(buffer, 0, buffer.Length);
                    while (count > 0)
                    {
                        fs.Write(buffer, 0, count);
                        count = response.GetResponseStream().Read(buffer, 0, buffer.Length);
                    }
                    response.GetResponseStream().Close();
                }
                result = true;
            }
            return result;
        }
        #endregion

        #region 重命名FTP服務器上的文件
        /// <summary>
        /// 文件更名
        /// </summary>
        /// <param name="oldFileName">原文件名</param>
        /// <param name="newFileName">新文件名</param>
        /// <returns>返回一個值,指示更名是否成功</returns>
        public bool Rename(string oldFileName, string newFileName)
        {
            bool result = false;
            //建立連接
            string url = Host.TrimEnd('/') + RemotePath + oldFileName;
            FtpWebRequest request = CreateRequest(url, WebRequestMethods.Ftp.Rename);
            request.RenameTo = newFileName;
            using (FtpWebResponse response = (FtpWebResponse)request.GetResponse())
            {
                result = true;
            }
            return result;
        }
        #endregion

        #region 從當前目錄下獲取文件列表
        /// <summary>
        /// 獲取當前目錄下文件列表
        /// </summary>
        /// <returns></returns>
        public List<string> GetFileList()
        {
            List<string> result = new List<string>();
            //建立連接
            string url = Host.TrimEnd('/') + RemotePath;
            FtpWebRequest request = CreateRequest(url, WebRequestMethods.Ftp.ListDirectory);
            using (FtpWebResponse response = (FtpWebResponse)request.GetResponse())
            {
                StreamReader reader = new StreamReader(response.GetResponseStream(), System.Text.Encoding.Default);//中文文件名
                string line = reader.ReadLine();
                while (line != null)
                {
                    result.Add(line);
                    line = reader.ReadLine();
                }
            }
            return result;
        }
        #endregion

        #region 從FTP服務器上獲取文件和文件夾列表
        /// <summary>
        /// 獲取詳細列表
        /// </summary>
        /// <returns></returns>
        public List<string> GetFileDetails()
        {
            List<string> result = new List<string>();
            //建立連接
            string url = Host.TrimEnd('/') + RemotePath;
            FtpWebRequest request = CreateRequest(url, WebRequestMethods.Ftp.ListDirectoryDetails);
            using (FtpWebResponse response = (FtpWebResponse)request.GetResponse())
            {
                StreamReader reader = new StreamReader(response.GetResponseStream(), System.Text.Encoding.Default);//中文文件名
                string line = reader.ReadLine();
                while (line != null)
                {
                    result.Add(line);
                    line = reader.ReadLine();
                }
            }
            return result;
        }
        #endregion

        #region 從FTP服務器上刪除文件
        /// <summary>
        /// 刪除FTP服務器上的文件
        /// </summary>
        /// <param name="fileName">文件名稱</param>
        /// <returns>返回一個值,指示是否刪除成功</returns>
        public bool DeleteFile(string fileName)
        {
            bool result = false;
            //建立連接
            string url = Host.TrimEnd('/') + RemotePath + fileName;
            FtpWebRequest request = CreateRequest(url, WebRequestMethods.Ftp.DeleteFile);
            using (FtpWebResponse response = (FtpWebResponse)request.GetResponse())
            {
                result = true;
            }

            return result;
        }
        #endregion

        #region 在FTP服務器上創建目錄
        /// <summary>
        /// 在當前目錄下創建文件夾
        /// </summary>
        /// <param name="dirName">文件夾名稱</param>
        /// <returns>返回一個值,指示是否創建成功</returns>
        public bool MakeDirectory(string dirName)
        {
            bool result = false;
            //建立連接
            string url = Host.TrimEnd('/') + RemotePath + dirName;
            FtpWebRequest request = CreateRequest(url, WebRequestMethods.Ftp.MakeDirectory);
            using (FtpWebResponse response = (FtpWebResponse)request.GetResponse())
            {
                result = true;
            }
            return result;
        }
        #endregion

        #region 從FTP服務器上刪除目錄
        /// <summary>
        /// 刪除文件夾
        /// </summary>
        /// <param name="dirName">文件夾名稱</param>
        /// <returns>返回一個值,指示是否刪除成功</returns>
        public bool DeleteDirectory(string dirName)
        {
            bool result = false;
            //建立連接
            string url = Host.TrimEnd('/') + RemotePath + dirName;
            FtpWebRequest request = CreateRequest(url, WebRequestMethods.Ftp.RemoveDirectory);
            using (FtpWebResponse response = (FtpWebResponse)request.GetResponse())
            {
                result = true;
            }
            return result;
        }
        #endregion

        #region 從FTP服務器上獲取文件大小
        /// <summary>
        /// 獲取文件大小
        /// </summary>
        /// <param name="fileName"></param>
        /// <returns></returns>
        public long GetFileSize(string fileName)
        {
            long result = 0;
            //建立連接
            string url = Host.TrimEnd('/') + RemotePath + fileName;
            FtpWebRequest request = CreateRequest(url, WebRequestMethods.Ftp.GetFileSize);
            using (FtpWebResponse response = (FtpWebResponse)request.GetResponse())
            {
                result = response.ContentLength;
            }

            return result;
        }
        #endregion

        #region 給FTP服務器上的文件追加內容
        /// <summary>
        /// 給FTP服務器上的文件追加內容
        /// </summary>
        /// <param name="localFile">本地文件</param>
        /// <param name="remoteFileName">FTP服務器上的文件</param>
        /// <returns>返回一個值,指示是否追加成功</returns>
        public bool Append(FileInfo localFile, string remoteFileName)
        {
            if (localFile.Exists)
            {
                using (FileStream fs = new FileStream(localFile.FullName, FileMode.Open))
                {
                    return Append(fs, remoteFileName);
                }
            }
            throw new Exception(string.Format("本地文件不存在,文件路徑:{0}", localFile.FullName));
        }

        /// <summary>
        /// 給FTP服務器上的文件追加內容
        /// </summary>
        /// <param name="stream">數據流(可通過設置偏移來實現從特定位置開始上傳)</param>
        /// <param name="remoteFileName">FTP服務器上的文件</param>
        /// <returns>返回一個值,指示是否追加成功</returns>
        public bool Append(Stream stream, string remoteFileName)
        {
            bool result = false;
            if (stream != null && stream.CanRead)
            {
                //建立連接
                string url = Host.TrimEnd('/') + RemotePath + remoteFileName;
                FtpWebRequest request = CreateRequest(url, WebRequestMethods.Ftp.AppendFile);
                using (Stream rs = request.GetRequestStream())
                {
                    //上傳數據
                    byte[] buffer = new byte[4096];//4K
                    int count = stream.Read(buffer, 0, buffer.Length);
                    while (count > 0)
                    {
                        rs.Write(buffer, 0, count);
                        count = stream.Read(buffer, 0, buffer.Length);
                    }
                    result = true;
                }
            }
            return result;
        }
        #endregion

        #region 獲取FTP服務器上的當前路徑
        /// <summary>
        /// 獲取FTP服務器上的當前路徑
        /// </summary>
        public string CurrentDirectory
        {
            get
            {
                string result = string.Empty;
                string url = Host.TrimEnd('/') + RemotePath;
                FtpWebRequest request = CreateRequest(url, WebRequestMethods.Ftp.PrintWorkingDirectory);
                using (FtpWebResponse response = (FtpWebResponse)request.GetResponse())
                {
                    string temp = response.StatusDescription;
                    int start = temp.IndexOf('"') + 1;
                    int end = temp.LastIndexOf('"');
                    if (end >= start)
                    {
                        result = temp.Substring(start, end - start);
                    }
                }
                return result;

            }
        }
        #endregion

        #region 檢查當前路徑上是否存在某個文件
        /// <summary>
        /// 檢查文件是否存在
        /// </summary>
        /// <param name="fileName">要檢查的文件名</param>
        /// <returns>返回一個值,指示要檢查的文件是否存在</returns>
        public bool CheckFileExist(string fileName)
        {
            bool result = false;
            if (fileName != null && fileName.Trim().Length > 0)
            {
                fileName = fileName.Trim();
                List<string> files = GetFileList();
                if (files != null && files.Count > 0)
                {
                    foreach (string file in files)
                    {
                        if (file.ToLower() == fileName.ToLower())
                        {
                            result = true;
                            break;
                        }
                    }
                }
            }
            return result;
        }
        #endregion

    }