.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 添加 (图片)、READ_MEDIA_FILES(通用)或 READ_EXTERNAL_STORAGE(旧版) iOS:在 Info.plist 添加 NSPhotoLibraryUsageDescription 等描述字段 运行时调用 Permissions.RequestAsync() 获取授权(推荐使用 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> { ... })});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、idcontent.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。
4. 服务端接收建议(以 ASP.NET Core 为例)
后端需能解析 multipart 请求,例如:
[HttpPost("upload")]public async Task 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上传文件到服务器的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1443284.html
微信扫一扫
支付宝扫一扫