MAUI类库FilePicker异步返回文本文件完整路径代码修复求助

问题根源分析 #

• CS1061错误：result.FullPath.ToString() 返回的是字符串类型，不是异步Task，所以不能用await修饰，属于对同步值误用异步等待的典型问题。
• 调用端未正确处理异步返回值：异步函数返回Task<string>，调用时必须用await获取实际结果，否则拿到的是Task对象而非路径字符串。

修复后的类库代码 #

假设原逻辑是通过FilePicker选择文本文件，修复后代码如下：

using Microsoft.Maui.Storage;

namespace YourMauiLibrary
{
    public static class FileHelper
    {
        // 异步返回文本文件的完整路径
        public static async Task<string> GetTextFileFullPathAsync()
        {
            var result = await FilePicker.PickAsync(new PickOptions
            {
                FileTypes = FilePickerFileType.Text
            });

            // 修复点：直接返回FullPath，无需await（它是同步字符串属性）
            return result?.FullPath;
        }
    }
}

修复后的调用代码 #

在MAUI页面或ViewModel中调用时，需在异步方法内使用await接收结果：

// 确保调用方法标记为async
private async void OnSelectFileClicked(object sender, EventArgs e)
{
    try
    {
        // 修复点：用await获取异步返回的路径字符串
        string filePath = await YourMauiLibrary.FileHelper.GetTextFileFullPathAsync();

        if (!string.IsNullOrEmpty(filePath))
        {
            // 后续读取文件的逻辑示例
            string fileContent = await File.ReadAllTextAsync(filePath);
            // 处理文件内容...
        }
    }
    catch (Exception ex)
    {
        // 处理异常（比如用户取消选择文件）
        Console.WriteLine($"Error: {ex.Message}");
    }
}

关键修复说明 #

1. 移除冗余await：result.FullPath是同步属性，直接返回或赋值即可，不需要异步等待。
2. 调用端正确使用await：异步方法返回Task<T>，必须用await提取T类型的实际值，否则得到的是Task<string>对象，无法直接作为文件路径使用。
3. 增加空值判断：用户可能取消文件选择，此时result为null，需处理避免空引用异常。

内容的提问来源于stack exchange，提问作者Jean-Marc Flamand