開源.NET FTP組件edtFTPnet 用法

edtFTPnet官方網站：
http://www.enterprisedt.com/products/edtftpnet/

目前最新版本為2.2.3，下載后在bin目錄中找到edtFTPnet.dll，在項目中添加引用。
下面為一些用法：

1、FTP服務器根目錄為web，在它下面創建如下圖示的目錄和上傳文件
FTPConnection.CommandEncoding = Encoding.GetEncoding("GBK") 指定GBK編碼以支持中文文件名
FTPConnection.CreateDirectory() 創建指定目錄
FTPConnection.ChangeWorkingDirectory() 切換到指定目錄
FTPConnection.UploadFile() 上傳文件

web
|-----L11
      |-----L21            
            |-----L31
                  |-----31.htm
            |-----21.htm
      |-----L22
      |-----11.htm
      |-----目錄.txt

private const string ftpServerIP = "xx.xx.xx.xx";
private const string ftpRemotePath = "web";
private const string ftpUserID = "user";
private const string ftpPassword = "123";

private void btnCreateAndUpload_Click(object sender, EventArgs e)
{          
    using (var conn = new FTPConnection
    {
        ServerAddress = ftpServerIP,
        ServerDirectory = ftpRemotePath,
        UserName = ftpUserID,
        Password = ftpPassword,
        CommandEncoding = Encoding.GetEncoding("GBK")
    })
    {
        conn.Connect();                

        //創建目錄L11
        conn.CreateDirectory("L11");

        //============切換當前工作目錄到L11============
        conn.ChangeWorkingDirectory("L11");
        //上行代碼也可以用conn.ServerDirectory = "L11";

        //上傳"文檔.txt"
        conn.UploadFile("文檔.txt", "文檔.txt");

        //創建子目錄L21,L22
        conn.CreateDirectory("L21");
        conn.CreateDirectory("L22");

        //在當前工作目錄L11上傳文件"L11.htm"
        conn.UploadFile("11.htm", "11.htm");

        //============切換當前工作目錄到L21============
        conn.ChangeWorkingDirectory("L21");

        //上傳文件21.htm
        conn.UploadFile("21.htm", "21.htm");
        //創建目錄L31
        conn.CreateDirectory("L31");

        //============切換當前工作目錄到L31============
        conn.ChangeWorkingDirectory("L31");

        //上傳文件31.htm
        conn.UploadFile("31.htm", "31.htm");
    }
}

2、獲取文件信息
FTPConnection.GetFileInfos() 獲取文件和目錄詳細信息，結果的一個屬性Dir為true表示為目錄，否則為文件

private void btnList_Click(object sender, EventArgs e)
{
    using (var conn = new FTPConnection
    {
        ServerAddress = ftpServerIP,
        ServerDirectory = ftpRemotePath,
        UserName = ftpUserID,
        Password = ftpPassword,
        CommandEncoding = Encoding.GetEncoding("GBK")
    })
    {
        conn.Connect();
        //獲取指定目錄的所有子目錄和文件信息
        conn.ChangeWorkingDirectory("L11/L21");               
        var files1 = conn.GetFileInfos();
        ShowFileInfos(files1);
        /*結果如下：
         File, /web/L11/L21/21.htm, 21.htm, 11.2KB, 2013-9-26 14:51:00
         Dir, /web/L11/L21/L31, L31, 0KB, 2013-9-26 14:51:00
         */

        ////返回上級目錄，例子中為web/L11
        conn.ChangeWorkingDirectoryUp();
        var files2 = conn.GetFileInfosRecursive();
        ShowFileInfos(files2);
        /*結果如下：
        File, /web/L11/11.htm, 11.htm, 59.4KB, 2013-9-26 14:51:00
        Dir, /web/L11/L21, L21, 0KB, 2013-9-26 14:51:00
        Dir, /web/L11/L22, L22, 0KB, 2013-9-26 14:51:00
        File, /web/L11/文檔.txt, 文檔.txt, 40.8KB, 2013-9-26 14:51:00
        File, /web/L11/L21/21.htm, 21.htm, 11.2KB, 2013-9-26 14:51:00
        Dir, /web/L11/L21/L31, L31, 0KB, 2013-9-26 14:51:00
        File, /web/L11/L21/L31/31.htm, 31.htm, 5.6KB, 2013-9-26 14:51:00
         */
    }
}      
void ShowFileInfos(FTPFile[] files)
{
    foreach (var file in files)
    {
        string info = string.Format("{0}, {1}, {2}, {3}KB, {4}",
            file.Dir ? "Dir" : "File", file.Path, file.Name, Math.Round(file.Size / 1024.0, 1), file.LastModified);
        richTextBox1.AppendText(info + "\r\n");
    }
    richTextBox1.AppendText("\r\n");
}

其中遞歸獲取指定目錄的所有子目錄和文件信息的擴展方法GetFileInfosRecursive如下：

public static class FtpClientExtensions
{
    /// <summary>
    /// 遞歸獲取目錄的所有子目錄和文件信息
    /// </summary>
    public static FTPFile[] GetFileInfosRecursive(this FTPConnection conn)
    {
        var resultList = new List<FTPFile>();
        var fileInfos = conn.GetFileInfos();
        resultList.AddRange(fileInfos);
        foreach (var fileInfo in fileInfos)
        {
            if (fileInfo.Dir)
            {
                conn.ServerDirectory = fileInfo.Path;
                resultList.AddRange(conn.GetFileInfosRecursive());
            }
        }
        return resultList.ToArray();
    }
    /// <summary>
    /// 遞歸刪除目錄(包括所有子目錄和文件信息)
    /// </summary>
    public static void DeleteDirectoryRecursive(this FTPConnection conn, string directoryName)
    {
        conn.ChangeWorkingDirectory(directoryName);
        var fileInfos = conn.GetFileInfos();
        foreach (var fileInfo in fileInfos)
        {
            if (fileInfo.Dir)
                conn.DeleteDirectoryRecursive(fileInfo.Name);
            else
                conn.DeleteFile(fileInfo.Name);
        }
        conn.ChangeWorkingDirectoryUp();
        conn.DeleteDirectory(directoryName);
    }
}

3、刪除目錄及所有子目錄和文件
FTPConnection.DeleteDirectory()當刪除的目錄不為空時，會出錯，需遞歸刪除，
遞歸刪除目錄擴展方法DeleteDirectoryRecursive見上面類FtpClientExtensions

private void btnDelete_Click(object sender, EventArgs e)
{
    using (var conn = new FTPConnection
    {
        ServerAddress = ftpServerIP,
        ServerDirectory = ftpRemotePath,
        UserName = ftpUserID,
        Password = ftpPassword,
        CommandEncoding = Encoding.GetEncoding("GBK")
    })
    {
        conn.Connect();              
        //遞歸刪除目錄及所有子目錄和文件
        conn.DeleteDirectoryRecursive("L11");
        //如果刪除單個文件，路徑為當前目錄的相對路徑
        //conn.DeleteFile("L11/11.htm");
    }
}