MAUI怎么从相册选择图片 MAUI图片选择器用法

来源:这里教程网 时间:2026-02-21 17:33:39 作者:

在 .NET MAUI 中,从相册选择图片推荐使用 MediaPicker.PickPhotosAsync,这是官方封装的跨平台媒体选择器,支持多选、尺寸压缩、自动旋转等实用功能,且 Android 13+ 默认调用系统照片选择器(Photo Picker),无需额外权限。

基础单张图片选择

调用

PickPhotoAsync
即可打开系统相册,用户选一张后返回
FileResult

代码简洁,一行即可启动:
var file = await MediaPicker.PickPhotoAsync();
若用户取消,返回
null
,需判空处理
支持直接读取流:
using var stream = await file.OpenReadAsync();

多张图片批量选择

使用

PickPhotosAsync
并设置
SelectionLimit
参数,例如最多选 10 张:

var results = await MediaPicker.PickPhotosAsync(new MediaPickerOptions { SelectionLimit = 10 });
返回
List<fileresult></fileresult>
,为空表示用户取消操作
Android 13+ 自动启用 Photo Picker 多选界面;旧版本回退到传统图库(需存储权限)

图片预处理选项(可选)

MediaPickerOptions
中可指定常见后处理行为,避免手动压缩或旋转:

MaximumWidth / MaximumHeight
:等比缩放至指定尺寸内(单位像素)
CompressionQuality = 85
:JPEG 压缩质量(0–100)
RotateImage = true
:按 EXIF 自动校正方向
PreserveMetaData = false
:默认不保留元数据(减小体积)

平台注意事项

大部分场景无需额外配置,但要注意:

Android:MAUI 8+ 在 Android 13+ 上默认使用 Photo Picker(无需
READ_MEDIA_IMAGES
权限);Android 12 及以下仍需申请存储权限
iOS:自动适配相册权限,首次调用会弹出授权请求 Windows/macOS:目前仅支持拍照,暂不支持相册选择(
PickPhotosAsync
返回空列表)

基本上就这些。用好

PickPhotosAsync
就能覆盖绝大多数图片选择需求,不复杂但容易忽略预处理参数和平台兼容性细节。

相关推荐