MAUI怎么监听网络状态变化 MAUI Connectivity教程

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

MAUI 监听网络状态变化，核心靠 Microsoft.Maui.Essentials.Connectivity，它跨平台、开箱即用，不需要额外权限（iOS/Android 侧系统已默认支持），也不用写原生桥接代码。

获取当前网络访问状态

Connectivity 提供的是“是否能访问互联网”的语义判断，不是单纯看有没有连上 WiFi 或蜂窝网。关键看 NetworkAccess 枚举：

NetworkAccess.Internet：设备可访问公网（如能打开 google.com）
NetworkAccess.Local：仅局域网通（比如连了 WiFi 但没网关/没外网）
NetworkAccess.None：完全无网络连接

用法很简单：

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 / 蜂窝 / 以太网）

如果业务需要按网络类型做策略（例如只在 WiFi 下自动更新），用 ConnectionProfiles：

ConnectionProfile.WiFi
ConnectionProfile.Cellular
ConnectionProfile.Ethernet
ConnectionProfile.Unknown

示例判断是否在 WiFi：

bool isOnWifi = Connectivity.Current.ConnectionProfiles.Contains(ConnectionProfile.WiFi);

注意：多个 profile 可能同时存在（如 WiFi + 蓝牙 PAN），所以要用 Contains 而非直接比对。

离线场景下的实用建议

真实用户场景中，光知道“离线”还不够，还得处理得自然：

界面层加个轻量提示条（非弹窗），2 秒后自动收起
API 请求失败时，先检查 Connectivity.Current.NetworkAccess，再决定重试 or 缓存队列
本地数据库操作照常执行，等联网后再同步（配合依赖注入封装同步逻辑）
iOS 模拟器偶尔返回不准确状态，真机测试更可靠

基本上就这些。Connectivity API 设计简洁，重点是把 NetworkAccess 和 ConnectionProfiles 的语义理解清楚，别把它当成“是否有信号”来用。

# android # go # 云服务 # internet # 以太网 # access # wifi # ai # ios # microsoft # 封装 # 事件 # 数据库 # 离线 # 互联网 # 的是 # 就会 # 多个 # 不需要 # 网通 # 把它 # 很简单 # 要用

返回目录在线咨询

上一篇：图解Javascript——作用域、作用域链、闭包
下一篇：如何利用ASP.NET企业自助建站系统进行移动响应式设计？

您的项目需求