开源.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

[csharp] view plaincopyprint?

1. private const string ftpServerIP = "xx.xx.xx.xx";
2. private const string ftpRemotePath = "web";
3. private const string ftpUserID = "user";
4. private const string ftpPassword = "123";
5. private void btnCreateAndUpload_Click(object sender, EventArgs e)
6. {
7. using (var conn = new FTPConnection
8. {
9. ServerAddress = ftpServerIP,
10. ServerDirectory = ftpRemotePath,
11. UserName = ftpUserID,
12. Password = ftpPassword,
13. CommandEncoding = Encoding.GetEncoding("GBK")
14. })
15. {
16. conn.Connect();
17. //创建目录L11
18. conn.CreateDirectory("L11");
19. //============切换当前工作目录到L11============
20. conn.ChangeWorkingDirectory("L11");
21. //上行代码也可以用conn.ServerDirectory = "L11";
22. //上传"文档.txt"
23. conn.UploadFile("文档.txt", "文档.txt");
24. //创建子目录L21,L22
25. conn.CreateDirectory("L21");
26. conn.CreateDirectory("L22");
27. //在当前工作目录L11上传文件"L11.htm"
28. conn.UploadFile("11.htm", "11.htm");
29. //============切换当前工作目录到L21============
30. conn.ChangeWorkingDirectory("L21");
31. //上传文件21.htm
32. conn.UploadFile("21.htm", "21.htm");
33. //创建目录L31
34. conn.CreateDirectory("L31");
35. //============切换当前工作目录到L31============
36. conn.ChangeWorkingDirectory("L31");
37. //上传文件31.htm
38. conn.UploadFile("31.htm", "31.htm");
39. }
40. }

2、获取文件信息

FTPConnection.GetFileInfos() 获取文件和目录详细信息，结果的一个属性Dir为true表示为目录，否则为文件

[csharp] view plaincopyprint?

1. private void btnList_Click(object sender, EventArgs e)
2. {
3. using (var conn = new FTPConnection
4. {
5. ServerAddress = ftpServerIP,
6. ServerDirectory = ftpRemotePath,
7. UserName = ftpUserID,
8. Password = ftpPassword,
9. CommandEncoding = Encoding.GetEncoding("GBK")
10. })
11. {
12. conn.Connect();
13. //获取指定目录的所有子目录和文件信息
14. conn.ChangeWorkingDirectory("L11/L21");
15. var files1 = conn.GetFileInfos();
16. ShowFileInfos(files1);
17. /*结果如下：
18. File, /web/L11/L21/21.htm, 21.htm, 11.2KB, 2013-9-26 14:51:00
19. Dir, /web/L11/L21/L31, L31, 0KB, 2013-9-26 14:51:00
20. */
21. ////返回上级目录，例子中为web/L11
22. conn.ChangeWorkingDirectoryUp();
23. var files2 = conn.GetFileInfosRecursive();
24. ShowFileInfos(files2);
25. /*结果如下：
26. File, /web/L11/11.htm, 11.htm, 59.4KB, 2013-9-26 14:51:00
27. Dir, /web/L11/L21, L21, 0KB, 2013-9-26 14:51:00
28. Dir, /web/L11/L22, L22, 0KB, 2013-9-26 14:51:00
29. File, /web/L11/文档.txt, 文档.txt, 40.8KB, 2013-9-26 14:51:00
30. File, /web/L11/L21/21.htm, 21.htm, 11.2KB, 2013-9-26 14:51:00
31. Dir, /web/L11/L21/L31, L31, 0KB, 2013-9-26 14:51:00
32. File, /web/L11/L21/L31/31.htm, 31.htm, 5.6KB, 2013-9-26 14:51:00
33. */
34. }
35. }
36. void ShowFileInfos(FTPFile[] files)
37. {
38. foreach (var file in files)
39. {
40. string info = string.Format("{0}, {1}, {2}, {3}KB, {4}",
41. file.Dir ? "Dir" : "File", file.Path, file.Name, Math.Round(file.Size / 1024.0, 1), file.LastModified);
42. richTextBox1.AppendText(info + "\r\n");
43. }
44. richTextBox1.AppendText("\r\n");
45. }

其中递归获取指定目录的所有子目录和文件信息的扩展方法GetFileInfosRecursive如下：

[csharp] view plaincopyprint?

1. public static class FtpClientExtensions
2. {
3. /// <summary>
4. /// 递归获取目录的所有子目录和文件信息
5. /// </summary>
6. public static FTPFile[] GetFileInfosRecursive(this FTPConnection conn)
7. {
8. var resultList = new List<FTPFile>();
9. var fileInfos = conn.GetFileInfos();
10. resultList.AddRange(fileInfos);
11. foreach (var fileInfo in fileInfos)
12. {
13. if (fileInfo.Dir)
14. {
15. conn.ServerDirectory = fileInfo.Path;
16. resultList.AddRange(conn.GetFileInfosRecursive());
17. }
18. }
19. return resultList.ToArray();
20. }
21. /// <summary>
22. /// 递归删除目录(包括所有子目录和文件信息)
23. /// </summary>
24. public static void DeleteDirectoryRecursive(this FTPConnection conn, string directoryName)
25. {
26. conn.ChangeWorkingDirectory(directoryName);
27. var fileInfos = conn.GetFileInfos();
28. foreach (var fileInfo in fileInfos)
29. {
30. if (fileInfo.Dir)
31. conn.DeleteDirectoryRecursive(fileInfo.Name);
32. else
33. conn.DeleteFile(fileInfo.Name);
34. }
35. conn.ChangeWorkingDirectoryUp();
36. conn.DeleteDirectory(directoryName);
37. }
38. }

3、删除目录及所有子目录和文件

FTPConnection.DeleteDirectory()当删除的目录不为空时，会出错，需递归删除，
递归删除目录扩展方法DeleteDirectoryRecursive见上面类FtpClientExtensions

[csharp] view plaincopyprint?

1. private void btnDelete_Click(object sender, EventArgs e)
2. {
3. using (var conn = new FTPConnection
4. {
5. ServerAddress = ftpServerIP,
6. ServerDirectory = ftpRemotePath,
7. UserName = ftpUserID,
8. Password = ftpPassword,
9. CommandEncoding = Encoding.GetEncoding("GBK")
10. })
11. {
12. conn.Connect();
13. //递归删除目录及所有子目录和文件
14. conn.DeleteDirectoryRecursive("L11");
15. //如果删除单个文件，路径为当前目录的相对路径
16. //conn.DeleteFile("L11/11.htm");
17. }
18. }