6.24上传文件资源

创建于 2026 年 8 月 17 日约 2 分钟读完

在互联网应用中，用户上传文件是一项常见需求，涵盖设置头像、发布图文动态、上传相册至网盘、分享 Vlog 到视频社区等场景。以下展示了多种文件上传的实现方式。

使用 Form 表单方式上传

cs
await httpRemoteService.PostAsync("https://localhost:7044/HttpRemote/AddFile", builder => builder    .SetMultipartContent(multipart => multipart        .AddFileAsStream(@"C:\Workspaces\httptest.jpg", "file")));

若需上传多个文件，只需在 multipart 中继续添加（需保持表单名一致，如 files）：

cs
await httpRemoteService.PostAsync("https://localhost:7044/HttpRemote/AddFiles", builder => builder    .SetMultipartContent(multipart => multipart        .AddFileAsStream(@"C:\Workspaces\httptest.jpg", "files")        .AddFileFromRemote("https://furion.net/img/furionlogo.png", "files")));

此外，还支持使用构建器模式，以及获取上传文件的返回值。更多详情可参考第 2.1 节。

cs
// 使用构建器模式await httpRemoteService.SendAsync(HttpRequestBuilder.Post("https://localhost:7044/HttpRemote/AddFile")    .SetMultipartContent(multipart => multipart        .AddFileAsStream(@"C:\Workspaces\httptest.jpg", "file")));// 更多详细用法可参考第 2.1 节

然而，这种上传文件资源的方式在面对多种复杂场景时显得不够灵活，例如无法实时追踪上传进度、限制上传文件类型和大小的情况，以及实现断点续传等。此外，它还可能需要开发者编写更多的额外代码。因此，框架中集成了专门设计用于上传文件资源的功能，以应对这些问题。

利用框架内置的专用上传功能进行上传（表单方式）

在视频分享等应用中，用户上传文件时通常需要查看实时进度。为此，可使用 UploadFile 扩展方法，该方法支持实时进度获取，并允许对文件类型和大小进行限制。

以下示例展示了如何打印上传进度：

cs
await httpRemoteService.UploadFileAsync("https://localhost:7044/HttpRemote/AddFile", @"C:\Workspaces\httptest.jpg", "file"    , async progress =>    {        Console.WriteLine(await progress.ToSummaryStringAsync());  // 输出简要进度信息    });

控制台输出示例：

bash
Transferred 0.01MB of 0.01MB (100.00% complete, Speed: 0.86MB/s, Time: 0.01s, ETA: 0.00s), File: httptest.jpg, Path: C:\Workspaces\httptest.jpg.

若需在控制台中实时显示文件上传进度，推荐使用 UpdateConsoleProgressAsync() 方法。示例如下：

cs
await httpRemoteService.UploadFileAsync("https://localhost:7044/HttpRemote/AddFile", @"C:\Workspaces\httptest.jpg", "file"    , progress => progress.UpdateConsoleProgressAsync()); // 在控制台中更新文件传输进度条// ✅ 或使用 UploadFileWithConsoleProgressAsync 方法（带控制台进度打印）await httpRemoteService.UploadFileWithConsoleProgressAsync("https://localhost:7044/HttpRemote/AddFile", @"C:\Workspaces\httptest.jpg", "file");

执行后，控制台将显示如下进度信息：

bash
File: httptest.jpg, Path: C:\Workspaces\httptest.jpg.[##################################################] 61.35% (0.01MB/0.01MB) Speed: 0.86MB/s, Time: 0.01s, ETA: 0.00s.

若需限制文件类型和大小，可如下操作：

cs
await httpRemoteService.SendAsync(HttpRequestBuilder.UploadFile("https://localhost:7044/HttpRemote/AddFile", @"C:\Workspaces\httptest.jpg", "file"    , async progress =>    {        Console.WriteLine(await progress.ToSummaryStringAsync());  // 输出简要进度信息    })    .SetAllowedFileExtensions(".jpg;.png")  // 仅允许 jpg 和 png 类型    .SetMaxFileSizeInBytes(5 * 1024 * 1024));  // 限制文件大小为 5MB

若需在上传文件时附加额外的表单参数，可如下操作：

cs
await httpRemoteService.SendAsync(HttpRequestBuilder.UploadFile("https://localhost:7044/HttpRemote/AddFile", @"C:\Workspaces\httptest.jpg", "file"    , async progress =>    {        Console.WriteLine(await progress.ToSummaryStringAsync());  // 输出简要进度信息    })    .WithMultipart(multipart =>    {        multipart.AddText("Furion", "name");    });

通过上述方式，可以灵活满足各类文件上传需求。