.NET MAUI Image控件加载本地图片失败：如何捕获异常并显示警告？

方法一：利用Image控件的ImageFailed事件 #

这是最直接的方式，MAUI的Image控件内置了ImageFailed事件，当图片加载失败（比如文件损坏）时会触发该事件，你可以在事件回调中切换显示警告符号。

代码示例： #

XAML部分：

<Image x:Name="MyImage" 
       Source="/path/to/your/image.jpg"
       ImageFailed="MyImage_ImageFailed" />
<!-- 提前准备好警告符号的图片，放在项目资源中 -->
<Image x:Name="WarningIcon" 
       Source="warning_icon.png" 
       IsVisible="False" />

后台C#代码：

private void MyImage_ImageFailed(object sender, EventArgs e)
{
    // 隐藏原图片，显示警告符号
    MyImage.IsVisible = false;
    WarningIcon.IsVisible = true;
}

方法二：提前验证图片文件有效性 #

在加载图片前先检查文件是否可正常读取，从源头避免加载失败的情况。可以通过读取文件头判断格式，或者用专业图像处理库验证。

基础文件流验证（以JPG为例）： #

public bool IsImageValid(string imagePath)
{
    if (!File.Exists(imagePath))
        return false;

    try
    {
        using (var stream = new FileStream(imagePath, FileMode.Open, FileAccess.Read))
        {
            // 读取JPG文件头标识验证
            byte[] header = new byte[2];
            stream.Read(header, 0, 2);
            return header[0] == 0xFF && header[1] == 0xD8;
        }
    }
    catch
    {
        return false;
    }
}

// 使用示例
string imagePath = "/Users/frank/Library/xxx.jpg";
if (IsImageValid(imagePath))
{
    MyImage.Source = imagePath;
    MyImage.IsVisible = true;
    WarningIcon.IsVisible = false;
}
else
{
    MyImage.IsVisible = false;
    WarningIcon.IsVisible = true;
}

如果要支持多种图片格式，推荐用ImageSharp（需安装SixLabors.ImageSharp NuGet包）：

using SixLabors.ImageSharp;

public bool IsImageValid(string imagePath)
{
    if (!File.Exists(imagePath))
        return false;

    try
    {
        using (Image.Load(imagePath))
        {
            return true;
        }
    }
    catch
    {
        return false;
    }
}

方法三：自定义绑定转换器（适配MVVM模式） #

如果用MVVM开发，可以创建一个转换器，绑定图片路径时自动验证，失败则返回警告图的源。

转换器代码： #

public class ImageSourceConverter : IValueConverter
{
    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
    {
        string imagePath = value as string;
        if (string.IsNullOrEmpty(imagePath))
            return ImageSource.FromFile("warning_icon.png");

        return IsImageValid(imagePath) 
            ? ImageSource.FromFile(imagePath) 
            : ImageSource.FromFile("warning_icon.png");
    }

    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
    {
        throw new NotImplementedException();
    }

    // 复用前面的IsImageValid方法
    private bool IsImageValid(string imagePath)
    {
        // 实现同上
    }
}

XAML中使用转换器：

<ContentPage.Resources>
    <local:ImageSourceConverter x:Key="ImageSourceConverter" />
</ContentPage.Resources>

<Image Source="{Binding ImagePath, Converter={StaticResource ImageSourceConverter}}" />

内容的提问来源于stack exchange，提问作者iosdeveloper