一:简介
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站【黑哥聊编程】