.NET MAUI如何上传XML文件 HttpClient的用法

在.NET MAUI应用开发场景中，上传XML文件到服务端是很多业务场景的必备功能，结合HttpClient可以高效实现该需求，下面将从文件选取到上传完成的全流程展开说明。

前期准备

首先需要在.NET MAUI项目的平台配置中开启文件访问权限，不同平台的配置方式略有差异：

• Android平台：在Platforms/Android/AndroidManifest.xml中添加读取存储的权限声明
• iOS平台：在Platforms/iOS/Info.plist中配置文件访问相关的键值对
• Windows平台：默认支持本地文件访问，无需额外配置

选取XML文件

使用.NET MAUI提供的文件选择器API来选取本地XML文件，代码示例如下：

using Microsoft.Maui.Storage;

public async Task<FileResult> PickXmlFile()
{
    // 设置文件选择过滤器，仅显示XML文件
    var customFileType = new FilePickerFileType(
        new Dictionary<DevicePlatform, IEnumerable<string>>
        {
            { DevicePlatform.Android, new[] { "text/xml" } },
            { DevicePlatform.iOS, new[] { "public.xml" } },
            { DevicePlatform.WinUI, new[] { ".xml" } }
        });

    var options = new PickOptions
    {
        PickerTitle = "选择要上传的XML文件",
        FileTypes = customFileType
    };

    try
    {
        var fileResult = await FilePicker.Default.PickAsync(options);
        return fileResult;
    }
    catch (Exception ex)
    {
        // 处理用户取消选择或权限不足的情况
        Console.WriteLine($"选取文件失败：{ex.Message}");
        return null;
    }
}

构造上传请求

使用HttpClient构造上传XML文件的请求，需要注意设置正确的请求头和请求内容：

using System.Net.Http;
using System.Text;

public async Task<bool> UploadXmlFile(string filePath, string uploadUrl)
{
    // 创建HttpClient实例，建议在实际项目中使用IHttpClientFactory管理生命周期
    using var httpClient = new HttpClient();
    // 设置请求超时时间
    httpClient.Timeout = TimeSpan.FromSeconds(30);

    try
    {
        // 读取XML文件内容
        string xmlContent = await File.ReadAllTextAsync(filePath, Encoding.UTF8);
        
        // 构造请求内容，设置媒体类型为text/xml
        var content = new StringContent(xmlContent, Encoding.UTF8, "text/xml");
        
        // 发送POST请求
        var response = await httpClient.PostAsync(uploadUrl, content);
        
        // 判断请求是否成功
        if (response.IsSuccessStatusCode)
        {
            return true;
        }
        else
        {
            string errorMsg = await response.Content.ReadAsStringAsync();
            Console.WriteLine($"上传失败，状态码：{response.StatusCode}，错误信息：{errorMsg}");
            return false;
        }
    }
    catch (HttpRequestException ex)
    {
        Console.WriteLine($"网络请求异常：{ex.Message}");
        return false;
    }
    catch (Exception ex)
    {
        Console.WriteLine($"上传过程发生异常：{ex.Message}");
        return false;
    }
}

完整调用流程

将文件选取和上传逻辑结合，实现完整的上传流程：

public async Task ExecuteUpload()
{
    // 第一步：选取XML文件
    var fileResult = await PickXmlFile();
    if (fileResult == null)
    {
        await Application.Current.MainPage.DisplayAlert("提示", "未选择文件", "确定");
        return;
    }

    // 第二步：执行上传，替换为实际的服务端接口地址
    string uploadUrl = "http://ipipp.com/api/upload-xml";
    bool uploadSuccess = await UploadXmlFile(fileResult.FullPath, uploadUrl);

    if (uploadSuccess)
    {
        await Application.Current.MainPage.DisplayAlert("成功", "XML文件上传完成", "确定");
    }
    else
    {
        await Application.Current.MainPage.DisplayAlert("失败", "XML文件上传失败", "确定");
    }
}

注意事项

• 如果服务端需要接收文件流形式的上传，可以将StringContent替换为StreamContent，直接传递文件流，避免大文件读取时的内存占用过高问题
• 生产环境中建议对HttpClient进行单例管理，避免频繁创建销毁带来的性能损耗
• 上传前可以校验XML文件的格式合法性，避免上传无效内容到服务端
• 如果服务端需要身份认证，需要在HttpClient的请求头中添加对应的认证令牌

常见问题排查

.NET_MAUIHttpClientXML文件上传C#文件传输修改时间：2026-06-11 08:03:25