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。

标签： html android js 前端 json app 字节 后端 ai ios microsoft stream c#