一款适用于.Net的高性能文件上传项目

今天给大家推荐一款开源的适用于.Net的高性能文件上项目UploadStream。

背景

流式多部分文件上传是指将文件分成多个部分,然后逐个部分上传到服务器。这种方式可以减少内存使用,提高上传性能,尤其是在上传大型文件时。

由于微软官方推荐的流式多部分文件上传代码比较复杂,作者对微软官方推荐的流式多部分文件上传代码进行了简化和重写,使其更容易理解和使用。

微软​文档地址:
https://learn.microsoft.com/en-us/aspnet/core/mvc/models/file-uploads?view=aspnetcore-3.1

项目性能结果的报告地址:
https://medium.com/@ma1f/file-streaming-performance-in-dotnet-4dee608dd953

特点

优化多部分流式文件上传性能,提供 10 倍性能提升和 10%-40% 内存分配减少。

默认情况下,.Net模型表单模型绑定使用IEnumerable<IFormFile>将整个流加载到内存中。这对大型文件来说并不理想,因为流的处理应该在流式传输过程中发生,而不是将整个文件(s) 缓冲到内存/磁盘中。

该软件包允许通过委托异步处理上传流(StreamFiles<T>(Action<IFormFile> func)),同时保持通用的模型绑定功能和验证。

简而言之,该软件包可以显著提高大型文件上传的性能和内存效率。

用法

安装包

csharp 复制代码
> install-package UploadStream

定义一个UploadModel

csharp 复制代码
public class UploadModel 
{
	public string Name { get; set; }
    public string Description { get; set; }
    public List<IFormFile> Files { get; set; }
}

使用UploadStream

csharp 复制代码
[HttpPost("upload")]
public async Task<IActionResult> Upload(UploadModel model)
{
    byte[] buffer = new byte[4096];

    foreach (var s in model.Files)
        using (var stream = s.OpenReadStream())
            while (await stream.ReadAsync(buffer, 0, buffer.Length) > 0) ;

    return Ok(new
    {
        model.Name,
        model.Description,
        files = model.Files.Select(x => new {
            x.Name,
            x.FileName,
            x.ContentDisposition,
            x.ContentType,
            x.Length
        })
    });
}

项目地址:

https://github.com/ma1f/uploadstream

相关推荐
追逐时光者10 分钟前
C#/.NET/.NET Core技术前沿周刊 | 第 54 期(2025年9.8-9.14)
后端·.net
追逐时光者13 分钟前
C#/.NET/.NET Core编程技巧练习集,配套详细的文章教程讲解!
后端·.net
咕白m6258 小时前
C# Excel 读取入门教程:免费实现方法
c#·.net
唐青枫14 小时前
FluentData 从入门到精通:C#.NET 数据访问最佳实践
c#·.net
余衫马1 天前
开发指南:使用 MQTTNet 库构建 .Net 物联网 MQTT 应用程序
物联网·mqtt·.net
William Wang~2 天前
.net 类库生成的DLL源码混淆加密
.net
一个帅气昵称啊2 天前
Docker命令大全:从基础到高级实战指南
docker·容器·eureka·架构·.net
Eiceblue2 天前
使用 C# 设置 Excel 单元格格式
开发语言·后端·c#·.net·excel
喵叔哟2 天前
58.【.NET8 实战--孢子记账--从单体到微服务--转向微服务】--新增功能--图形验证码
微服务·架构·.net
Tiger_shl2 天前
【.Net技术栈梳理】08-控制反转(IoC)与依赖注入(DI)
开发语言·.net·.netcore