MAUI图片加载方法及Image控件使用教程
作者:SunnyJourney
时间:2026-01-01
来源:正软商城
浏览:12
MAUI中图片加载依赖Image控件,支持本地资源、嵌入式资源、网络地址和本地文件路径四种方式;需正确设置Source属性,并注意平台差异与异步行为。
本文目录
MAUI中图片加载依赖Image控件,支持本地资源、嵌入式资源、网络地址和本地文件路径四种方式;需正确设置Source属性,并注意平台差异与异步行为。

MAUI 中图片加载主要靠 Image 控件,支持本地资源、嵌入式资源、网络地址和本地文件路径四种方式。关键在于正确设置 Source 属性,并注意平台差异和异步加载行为。
加载本地资源图片(推荐用于图标、静态图)
把图片放进 Resources/Images 文件夹(如 dotnet.png),生成操作设为 MauiImage。XAML 中直接用资源名引用:
代码中也可这样写:
image.Source = "dotnet.png";
- 不需要写扩展名,MAUI 会自动匹配最佳格式(.png/.jpg/.svg 等)
- 支持多分辨率:按命名规则放
dotnet.png、dotnet@2x.png,系统自动选 - Android/iOS/macOS 都能识别,无需额外配置
加载网络图片(带自动缓存和占位图)
直接传 URL 字符串即可,MAUI 内置了基础缓存和错误处理:
建议配合 Aspect 和 Background 提升体验:
Aspect="AspectFit":保持宽高比,完整显示Aspect="AspectFill":填满区域,可能裁剪- 加
Background="LightGray"避免加载前白屏 - 可绑定
IsLoading或用Loaded事件做加载状态提示
加载嵌入式资源或 Stream(适合动态生成/加密图)
若图片来自程序集资源(如打包在 .NET 类库中),需用 ImageSource.FromStream:
var stream = GetType().Assembly.GetManifestResourceStream("MyApp.Resources.icon.svg");
image.Source = ImageSource.FromStream(() => stream);
- 确保资源的“生成操作”设为
EmbeddedResource - 流必须可重复读取(某些压缩流只读一次,需缓存到 MemoryStream)
- SVG 需要启用
Microsoft.Maui.Controls.Compatibility并注册渲染器(.NET 8+ 已原生支持部分 SVG)
加载本地文件路径(沙盒限制要注意)
仅限应用沙盒内路径(如 FileSystem.AppDataDirectory 下保存的图):
string path = Path.Combine(FileSystem.AppDataDirectory, "downloaded.jpg"); image.Source = ImageSource.FromFile(path);
- iOS 和 Android 对外部路径访问严格,不能直接用
/sdcard/xxx或~/Documents - 用
FileSystem.OpenAppPackageFileAsync可读取安装包内的文件(如更新后替换的资源) - 加载失败时
Image默认不报错,建议监听OnError事件排查
基本上就这些。MAUI 的 Image 控件用法简洁,但要注意资源路径规则、平台适配和异步加载时机——不复杂但容易忽略。
作者最新文章
AO3如何加入系列|作品归入现有系列教程
2026-11-18 17:43
俄罗斯Yandex官网入口及外贸查询工具
2026-11-16 17:53
Yandex官网入口及网页搜索使用方法
2026-11-10 18:27
免注册Word转PDF在哪里?Word转PDF手机电脑都能用
2026-11-08 15:29
xshell如何使用密钥连接服务器
2026-11-05 21:38
上一篇:
USB驱动保护设置全攻略
热门文章
更多
精品专题
更多
Mac软件
更多
火山引擎 网页版
Windows/ macOS/ Linux
火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。
















