C# MAUI怎么实现文件上传 MAUI上传文件到服务器
.NET MAUI 文件上传需三步:1. 申请存储读取权限(Android/iOS);2. 用 FilePicker.PickAsync 选文件并读为字节数组;3. 用 HttpClient 构造 MultipartFormDataContent 发送,注意流一次性及前后端字段名、MIME 对齐。

在 .NET MAUI 中实现文件上传,核心思路是:先用 FilePicker 选中本地文件,读取为字节数组或流,再通过 HttpClient 以 multipart/form-data 方式发送到服务器。MAUI 本身不内置“上传控件”,需手动组合 API 完成。
1. 请求文件访问权限(Android/iOS 平台必需)
尤其在 Android 10+ 和 iOS 上,读取相册、文档等需显式申请权限:
- Android:在
AndroidManifest.xml添加<uses-permission android:name="android.permission.READ_MEDIA_IMAGES"></uses-permission>(图片)、READ_MEDIA_FILES(通用)或READ_EXTERNAL_STORAGE(旧版) - iOS:在
Info.plist添加NSPhotoLibraryUsageDescription等描述字段 - 运行时调用
Permissions.RequestAsync<permissions.storageread>()</permissions.storageread>获取授权(推荐使用Microsoft.Maui.Essentials.Permissions)
2. 选择文件并读取为流
使用 FilePicker.PickAsync() 获取用户选中的文件,它返回 FileResult,包含可打开的 OpenReadAsync() 流:
var result = await FilePicker.PickAsync(new PickOptions
{
PickerTitle = "选择要上传的文件",
FileTypes = FilePickerFileType.Images // 或自定义 MimeType,如 new FilePickerFileType(new Dictionary<Device, IEnumerable<string>> { ... })
});
if (result != null)
{
using var stream = await result.OpenReadAsync();
// 后续用 stream 构建上传内容
}
3. 使用 HttpClient 发送 multipart 表单上传
服务器通常接收标准 HTML 表单格式(multipart/form-data),需构造 MultipartFormDataContent:
var client = new HttpClient(); var content = new MultipartFormDataContent(); // 添加文件流(name 字段需与后端约定,如 "file") var fileStream = await result.OpenReadAsync(); var fileBytes = await StreamToByteArrayAsync(fileStream); // 辅助方法:读取全部字节 var fileContent = new ByteArrayContent(fileBytes); fileContent.Headers.ContentType = MediaTypeHeaderValue.Parse(result.ContentType ?? "application/octet-stream"); content.Add(fileContent, "file", result.FileName); // 可选:添加其他字段,如 token、id content.Add(new StringContent("123", Encoding.UTF8), "userId"); var response = await client.PostAsync("https://your-api.com/upload", content); if (response.IsSuccessStatusCode) { var resultJson = await response.Content.ReadAsStringAsync(); }
注意:不要直接传 stream 到 StreamContent 并重复使用——MAUI 的 FileResult.OpenReadAsync() 返回的流是一次性流,且可能已关闭;稳妥做法是先读成 byte[] 或 MemoryStream。
站长俱乐部购物系统
功能介绍:1、模块化的程序设计,使得前台页面设计与程序设计几乎完全分离。在前台页面采用过程调用方法。在修改页面设计时只需要在相应位置调用设计好的过程就可以了。另外,这些过程还提供了不同的调用参数,以实现不同的效果;2、阅读等级功能,可以加密产品,进行收费管理;3、可以完全可视化编辑文章内容,所见即所得;4、无组件上传文件,服务器无需安装任何上传组件,无需支持FSO,即可上传文件。可限制文件上传的类
0
查看详情
4. 服务端接收建议(以 ASP.NET Core 为例)
后端需能解析 multipart 请求,例如:
[HttpPost("upload")]
public async Task<IActionResult> Upload(IFormFile file)
{
if (file == null || file.Length == 0)
return BadRequest("文件为空");
var uploadsFolder = Path.Combine(Directory.GetCurrentDirectory(), "uploads");
Directory.CreateDirectory(uploadsFolder);
var filePath = Path.Combine(uploadsFolder, file.FileName);
await using var stream = new FileStream(filePath, FileMode.Create);
await file.CopyToAsync(stream);
return Ok(new { message = "上传成功", fileName = file.FileName });
}
确保控制器参数名(file)与前端 content.Add(..., "file", ...) 中的 name 一致。
基本上就这些。MAUI 文件上传不复杂但容易忽略权限和流生命周期问题,重点盯住 FileResult.OpenReadAsync() 的一次性行为,以及前后端字段名、MIME 类型是否对齐。
以上就是C# MAUI怎么实现文件上传 MAUI上传文件到服务器的详细内容,更多请关注其它相关文章!

Content();
// 添加文件流(name 字段需与后端约定,如 "file")
var fileStream = await result.OpenReadAsync();
var fileBytes = await StreamToByteArrayAsync(fileStream); // 辅助方法:读取全部字节
var fileContent = new ByteArrayContent(fileBytes);
fileContent.Headers.ContentType = MediaTypeHeaderValue.Parse(result.ContentType ?? "application/octet-stream");
content.Add(fileContent, "file", result.FileName);
// 可选:添加其他字段,如 token、id
content.Add(new StringContent("123", Encoding.UTF8), "userId");
var response = await client.PostAsync("https://your-api.com/upload", content);
if (response.IsSuccessStatusCode)
{
var resultJson = await response.Content.ReadAsStringAsync();
}