一:簡介
FluentFTP 是一個完全托管的 .NET 和 .NET Standard 的 FTP 和 FTPS 庫,針對速度進行了優化。
它提供了廣泛的 FTP 命令、文件上傳/下載、SSL/TLS 連接、自動目錄列表解析、文件哈希/校驗和、
文件權限/CHMOD、FTP 代理、FXP 傳輸、UTF-8 支持、異步/等待支持、Powershell 支持和更多的。
它完全用 C# 編寫,沒有外部依賴項。FluentFTP 是在寬松的 MIT 許可證下發布的,因此它可以在專有和免費/開源應用程序中使用。
二:特征
完全支持FTP、FXP、FTPS(基於 SSL 的 FTP)、帶有客戶端證書的FTPS 和帶有 CCC的 FTPS (用於 FTP 防火牆)
完全遞歸的目錄列表和目錄刪除(手動遞歸和服務器端遞歸)
通過進度跟蹤輕松從服務器上傳和下載文件
使用簡單的同步模式從服務器輕松上傳和下載目錄
使用 FXP 協議輕松地將文件或文件夾直接從一台服務器傳輸到另一台服務器
使用基於規則的白名單和黑名單有條件地傳輸文件
自動驗證文件的哈希並在哈希不匹配時重試傳輸
多文件傳輸的可配置錯誤處理(忽略/中止/拋出)
使用標准流輕松地從服務器讀取和寫入文件數據
創建、追加、讀取、寫入、重命名、移動和刪除文件和文件夾
遞歸刪除文件夾及其所有內容
獲取文件/文件夾信息(存在、大小、安全標志、修改日期/時間)
獲取和設置文件權限(所有者、組、其他)
絕對或相對路徑(相對於“工作目錄”)
使用哈希/校驗和(MD5、CRC32、SHA-1、SHA-256、SHA-512)將本地文件與遠程文件進行比較
取消引用符號鏈接以計算鏈接的文件/文件夾
通過可配置的速度限制限制上傳和下載
三:異步支持:
對所有操作使用async/的同步和異步方法await
.NET 4.0 及以下使用模式的異步方法IAsyncResult(Begin*/End*)
所有異步方法都可以通過傳遞一個CancellationToken
所有異步方法都遵循ReadTimeout並在超時時自動取消
通過克隆文件傳輸的 FTP 控制連接來提高線程安全性(可選)
實現自己的內部鎖定以保持事務同步
四:使用
使用Nuget 搜索FluentFtp
public class FtpHelper { FtpClient _client; public FtpHelper() { _client = new FtpClient(CommonConst.Url); _client.Credentials = new System.Net.NetworkCredential(CommonConst.UserName, CommonConst.Pwd); _client.Connect(); } /// <summary> /// 上傳ftp /// </summary> /// <param name="originalAddress"></param> /// <param name="destinationAddress"></param> /// <returns></returns> public bool UpLoadFile(string originalAddress, string destinationAddress) { if (_client.UploadFile(originalAddress, destinationAddress, FtpRemoteExists.Overwrite, true) == FtpStatus.Success) { return true; } return false; } /// <summary> /// 以流的方式 ftp /// </summary> /// <param name="fileStream"></param> /// <param name="destinationAddress"></param> /// <returns></returns> public bool UpLoad(Stream fileStream, string destinationAddress) { if (_client.Upload(fileStream, destinationAddress, FtpRemoteExists.Overwrite, true) == FtpStatus.Success) { return true; } return false; } /// <summary> /// 下載ftp /// </summary> /// <param name="originalAddress"></param> /// <param name="destinationAddress"></param> /// <returns></returns> public bool DownloadFile(string originalAddress, string destinationAddress) { if (_client.DownloadFile(originalAddress, destinationAddress) == FtpStatus.Success) { return true; } return false; } /// <summary> /// 以流的方式下載 /// </summary> /// <param name="outStream"></param> /// <param name="destinationAddress"></param> /// <returns></returns> public bool DownloadStream(Stream outStream, string destinationAddress) { if (_client.Download(outStream, destinationAddress) == true) { return true; } return false; } }
最后大家如果喜歡我的文章,還麻煩給個關注, 希望net生態圈越來越好!
公眾號【黑哥聊dotNet】
b站【黑哥聊編程】