MAUI 监听网络状态变化核心依赖 Microsoft.Maui.Essentials.Connectivity,它跨平台、免权限、无需原生代码;通过 NetworkAccess 判断互联网可达性(Internet/Local/None),用 ConnectivityChanged 事件实时响应变化,并支持 ConnectionProfiles 区分 WiFi/蜂窝等类型。

MAUI 监听网络状态变化,核心靠 Microsoft.Maui.Essentials.Connectivity,它跨平台、开箱即用,不需要额外权限(iOS/Android 侧系统已默认支持),也不用写原生桥接代码。
Connectivity 提供的是“是否能访问互联网”的语义判断,不是单纯看有没有连上 WiFi 或蜂窝网。关键看 NetworkAccess 枚举:
用法很简单:
var access = Connectivity.Current.NetworkAccess;
if (access == NetworkAccess.Internet)
Console.WriteLine("在线,可发起 API 请求");
else if (access == NetworkAccess.Local)
Console.WriteLine("在内网,可能无法访问云服务");
else
Console.WriteLine("离线中");
别轮询,用 Connectivity.ConnectivityChanged 事件——只要网络状态一变(比如断网、切 WiFi、开启飞行模式),就会触发:
// 建议在页面或服务生命周期开始时注册
Connectivity.ConnectivityChanged += OnConnectivityChanged;
void OnConnectivityChanged(object sender, ConnectivityChangedEventArgs e)
{
var newAccess = e.NetworkAccess;
var profile = e.ConnectionProfiles; // 如 [Wifi], [Cellular]
if (newAccess == NetworkAccess.Internet)
ShowOnlineToast();
else
ShowOfflineHint();
}
⚠️ 注意:该事件是全局的,记得在页面销毁或服务停用时反注册,避免内存泄漏:
Connectivity.ConnectivityChanged -= OnConnectivityChanged;
如果业务需要按网络类型做策略(例如只在 WiFi 下自动更新),用 ConnectionProfiles:
示例判断是否在 WiFi:
bool isOnWifi = Connectivity.Current.ConnectionProfiles.Contains(ConnectionProfile.WiFi);
注意:多个 profile 可能同时存在(如 WiFi + 蓝牙 PAN),所以要用 Contains 而非直接比对。
真实用户场景中,光知道“离线”还不够,还得处理得自然:
Connectivity.Current.NetworkAccess,再决定重试 or 缓存队列基本上就这些。Connectivity API 设计简洁,重点是把 NetworkAccess 和 ConnectionProfiles 的语义理解清楚,别把它当成“是否有信号”来用。
以上就是MAUI怎么监听网络状态变化 MAUI Connectivity教程的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号