C#使用SimpleWifi库控制与扫描WiFi网络的实战指南

1次阅读

共计 2427 个字符，预计需要花费 7 分钟才能阅读完成。

在 C# 开发中，尤其是涉及到物联网、网络监控或自动化工具时，经常需要与 WiFi 网络进行交互。常见的需求包括扫描可用网络、连接特定网络、断开连接等。然而，Windows 平台下直接操作 WiFi 网络通常需要调用复杂的 Win32 API 或 WLAN API，这对开发者来说门槛较高，代码也较为复杂。

主要痛点包括：

原生 API 调用复杂，需要处理大量底层细节
不同 Windows 版本 API 可能有差异
缺乏统一的简化接口，导致开发效率低下
错误处理机制不够友好

在 C# 生态中，有几个可用于 WiFi 操作的库可供选择：

Windows Native WLAN API：最底层，功能最全但复杂度最高
ManagedWifi：对 WLAN API 的托管封装，中等复杂度
SimpleWifi：最高层封装，API 最简单

SimpleWifi 的优势：

简洁直观的 API 设计
不需要处理底层平台差异
良好的异常处理机制
开源且维护良好

其主要局限是功能相对基础，不适合需要深度定制 WiFi 行为的场景。

首先通过 NuGet 安装 SimpleWifi 包：

Install-Package SimpleWifi

using SimpleWifi;

// 创建 Wifi 实例
Wifi wifi = new Wifi();

// 检查 WiFi 是否可用
if (!wifi.NoWifiAvailable)
{Console.WriteLine("WiFi 功能可用");
}

// 开始扫描
wifi.Scan();

// 获取所有可访问的接入点
List<AccessPoint> accessPoints = wifi.GetAccessPoints();

// 显示网络信息
foreach (AccessPoint ap in accessPoints)
{Console.WriteLine($"SSID: {ap.Name}");
    Console.WriteLine($"信号强度: {ap.SignalStrength}%");
    Console.WriteLine($"是否安全: {ap.HasProfile}");
    Console.WriteLine($"认证类型: {ap.AuthType}");
    Console.WriteLine();}

// 选择要连接的网络
AccessPoint targetAP = accessPoints.FirstOrDefault(ap => ap.Name == "目标网络名称");

if (targetAP != null)
{AuthRequest authRequest = new AuthRequest(targetAP);

    // 如果网络需要密码
    if (targetAP.HasProfile)
    {authRequest.Password = "网络密码";}

    // 尝试连接
    bool success = targetAP.Connect(authRequest);

    if (success)
    {Console.WriteLine("连接成功！");
    }
    else
    {Console.WriteLine("连接失败");
    }
}

扫描操作可能耗时 100-500 毫秒，建议异步执行
大量频繁扫描会影响网络性能
连接操作通常需要 1 - 3 秒完成

避免硬编码 WiFi 密码在代码中
考虑使用 Windows 凭据管理器存储敏感信息
处理连接失败时要清除内存中的密码
注意 AuthRequest 对象的生命周期管理

扫描不到网络
检查 WiFi 适配器是否启用
确保应用有足够的权限
尝试以管理员身份运行
连接失败
验证密码是否正确
检查认证类型是否匹配
查看 Windows 事件日志获取详细错误
权限问题
确保应用清单中请求了适当的权限
对于企业网络可能需要特殊配置
跨版本兼容性
在 Windows 7/8/10/11 上测试功能
注意不同 Windows 版本的 WiFi 栈差异

下面是一个简单的 WiFi 自动切换工具的代码框架：

public class WifiSwitcher
{
    private Wifi wifi;

    public WifiSwitcher()
    {wifi = new Wifi();
    }

    public async Task<bool> ConnectToBestNetwork(string preferredSsid = null)
    {await Task.Run(() => wifi.Scan());

        var networks = wifi.GetAccessPoints()
            .OrderByDescending(ap => ap.SignalStrength);

        if (!string.IsNullOrEmpty(preferredSsid))
        {var preferred = networks.FirstOrDefault(ap => ap.Name == preferredSsid);
            if (preferred != null)
            {return ConnectToNetwork(preferred);
            }
        }

        return ConnectToNetwork(networks.First());
    }

    private bool ConnectToNetwork(AccessPoint ap)
    {
        // 实际连接逻辑
        // ...
    }
}

尝试扩展上述代码，实现以下功能：