当前位置：首页 > news >正文

高效管理无线网卡：基于.NET的Windows WPF工具开发实战

news 2026/6/4 4:37:32

1. 为什么我们需要一个无线网卡管理工具？

作为一个经常需要切换网络环境的开发者，我发现自己每天要反复启用/禁用无线网卡不下十次。比如在会议室连接投影仪时需要临时关闭Wi-Fi，或者在家办公时需要快速切换到有线网络以获得更稳定的连接。Windows自带的网络管理界面操作路径太深（需要点击6次才能完成切换），而命令行操作又不够直观。这就是我决定开发这个工具的最初动机。

你可能不知道，Windows系统底层其实提供了丰富的网络管理API，但普通用户很难直接利用这些功能。通过.NET和WPF技术栈，我们可以将这些底层能力封装成简单易用的图形界面。实测下来，使用这个工具切换无线网卡状态只需要1次点击，比系统原生方式快了至少5倍。

2. 开发环境准备与项目搭建

2.1 基础开发环境配置

首先需要安装Visual Studio 2022（社区版即可），选择".NET桌面开发"工作负载。我推荐使用.NET 8这个长期支持版本，它在Windows原生互操作方面做了很多优化。创建一个新的WPF应用项目时，记得勾选"启用Docker支持"选项（虽然我们暂时用不到，但为后续扩展留有余地）。

项目结构建议采用标准的MVVM模式：

WifiManager/ ├── Models/ # 数据模型 ├── ViewModels/ # 业务逻辑 ├── Views/ # 界面组件 ├── Services/ # 底层服务 └── Assets/ # 静态资源

2.2 关键NuGet包引用

除了默认引用的WPF基础包，我们还需要添加几个关键依赖：

<PackageReference Include="Microsoft.Toolkit.Mvvm" Version="8.2.0" /> <PackageReference Include="Hardcodet.NotifyIcon.Wpf" Version="1.0.13" /> <PackageReference Include="Serilog" Version="3.1.1" />

第一个包提供了MVVM开发的基础设施，第二个是实现系统托盘图标的利器，第三个则是日志记录的瑞士军刀。在app.xaml.cs中初始化日志组件：

Log.Logger = new LoggerConfiguration() .WriteTo.File("wifi-manager.log") .CreateLogger();

3. 核心功能实现详解

3.1 无线网卡枚举与状态检测

获取无线网卡列表是首要任务。经过多次测试，我发现最可靠的方式是组合使用netsh命令和WMI查询：

public static List<NetworkAdapter> GetWirelessAdapters() { var adapters = new List<NetworkAdapter>(); // 方法1：使用netsh命令（最快） try { var process = new Process { StartInfo = new ProcessStartInfo { FileName = "netsh", Arguments = "wlan show interfaces", RedirectStandardOutput = true, UseShellExecute = false } }; process.Start(); var output = process.StandardOutput.ReadToEnd(); // 解析输出获取网卡信息 var matches = Regex.Matches(output, @"名称\s*:\s*(.+?)\r\n.*?GUID\s*:\s*({[A-F0-9-]+})"); foreach (Match match in matches) { adapters.Add(new NetworkAdapter { Name = match.Groups[1].Value.Trim(), Guid = match.Groups[2].Value }); } } catch { /* 失败时回退到方法2 */ } // 方法2：使用WMI查询（更全面） if (adapters.Count == 0) { using var searcher = new ManagementObjectSearcher( "SELECT * FROM Win32_NetworkAdapter WHERE NetConnectionID IS NOT NULL"); foreach (var obj in searcher.Get()) { if (obj["NetConnectionID"].ToString().Contains("Wireless")) { adapters.Add(new NetworkAdapter { Name = obj["NetConnectionID"].ToString(), Guid = obj["GUID"].ToString() }); } } } return adapters; }

3.2 网卡状态切换实现

启用/禁用网卡的核心代码其实很简单，但有几个关键细节需要注意：

public static bool ToggleAdapter(string adapterGuid, bool enable) { try { using var adapter = new ManagementObject( $"Win32_NetworkAdapter.DeviceID='{adapterGuid}'"); var result = adapter.InvokeMethod( enable ? "Enable" : "Disable", null); return (int)result == 0; } catch { // 回退到devcon.exe方案 return RunDevCon(adapterGuid, enable); } } private static bool RunDevCon(string guid, bool enable) { var process = new Process { StartInfo = new ProcessStartInfo { FileName = "devcon.exe", Arguments = $"{(enable ? "enable" : "disable")} \"{guid}\"", Verb = "runas", // 请求管理员权限 UseShellExecute = true } }; process.Start(); process.WaitForExit(); return process.ExitCode == 0; }

这里有个重要技巧：我们同时准备了两种实现方案。主方案使用WMI，回退方案使用devcon.exe。这是因为某些厂商的网卡驱动对WMI支持不完善，而devcon.exe是Windows官方工具，兼容性更好。

4. 用户体验优化技巧

4.1 系统托盘集成

一个好的工具应该做到"随用随走"。使用Hardcodet.NotifyIcon包可以轻松实现系统托盘功能：

<Window.Resources> <ContextMenu x:Key="TrayMenu"> <MenuItem Header="启用Wi-Fi" Command="{Binding EnableCommand}"/> <MenuItem Header="禁用Wi-Fi" Command="{Binding DisableCommand}"/> <Separator/> <MenuItem Header="退出" Command="{Binding ExitCommand}"/> </ContextMenu> </Window.Resources> <tb:TaskbarIcon IconSource="/Assets/wifi.ico" ToolTipText="Wi-Fi管理器" ContextMenu="{StaticResource TrayMenu}"/>

4.2 管理员权限处理

网络操作需要管理员权限，我们可以在项目属性中直接配置：

右键项目 → 属性 → 安全性 → 启用ClickOnce安全设置
编辑app.manifest文件，取消注释以下行：

<requestedExecutionLevel level="requireAdministrator" uiAccess="false" />

但这样每次启动都会弹出UAC提示。更好的做法是仅在需要时请求权限：

public static void RestartAsAdmin() { var startInfo = new ProcessStartInfo { FileName = Assembly.GetEntryAssembly().Location, UseShellExecute = true, Verb = "runas" }; Process.Start(startInfo); Application.Current.Shutdown(); }

5. 高级功能扩展

5.1 命令行支持

为方便高级用户，我们添加命令行参数支持：

static void Main(string[] args) { if (args.Length > 0) { // 命令行模式 var parser = new Parser(settings => { settings.CaseSensitive = false; settings.HelpWriter = Console.Out; }); parser.ParseArguments<Options>(args) .WithParsed(RunInCliMode); } else { // 图形界面模式 var app = new App(); app.InitializeComponent(); app.Run(); } } private static void RunInCliMode(Options opts) { if (opts.ListAdapters) { Console.WriteLine("可用无线网卡："); foreach (var adapter in GetWirelessAdapters()) { Console.WriteLine($"{adapter.Name} ({adapter.Guid})"); } return; } // 其他命令处理... }

5.2 多显示器适配

WPF在高DPI和多显示器环境下经常会出现显示问题。这是我总结的最佳实践：

protected override void OnSourceInitialized(EventArgs e) { base.OnSourceInitialized(e); // 获取当前屏幕信息 var screen = Screen.FromHandle(new WindowInteropHelper(this).Handle); var dpi = VisualTreeHelper.GetDpi(this); // 计算居中位置 Left = screen.WorkingArea.Left + (screen.WorkingArea.Width - ActualWidth * dpi.DpiScaleX) / 2; Top = screen.WorkingArea.Top + (screen.WorkingArea.Height - ActualHeight * dpi.DpiScaleY) / 2; }

6. 实际使用中的坑与解决方案

在开发过程中，我遇到了几个典型问题：

网卡状态更新延迟：禁用网卡后，系统需要几秒钟才能更新状态。解决方案是添加状态轮询机制：

async Task WaitForAdapterState(string guid, bool desiredState) { var timeout = DateTime.Now.AddSeconds(10); while (DateTime.Now < timeout) { if (GetAdapterState(guid) == desiredState) return; await Task.Delay(500); } throw new TimeoutException(); }

多语言系统兼容性：netsh命令的输出在不同语言系统下格式不同。我们通过检测系统语言来动态调整正则表达式：

var isChinese = CultureInfo.CurrentCulture.Name.StartsWith("zh"); var pattern = isChinese ? @"名称\s*:\s*(.+?)\r\n.*?GUID\s*:\s*({[A-F0-9-]+})" : @"Name\s*:\s*(.+?)\r\n.*?GUID\s*:\s*({[A-F0-9-]+})";

虚拟网卡干扰：某些VPN软件会创建虚拟网卡，我们需要在枚举时过滤掉它们：

if (adapter.Name.Contains("Virtual") || adapter.Name.Contains("VPN") || adapter.Name.Contains("TAP")) { continue; }

7. 性能优化实践

为了让工具启动更快，我做了这些优化：

延迟加载：将耗时的网卡枚举操作放到后台线程：

async void Window_Loaded(object sender, RoutedEventArgs e) { Adapters.Clear(); await Task.Run(() => { foreach (var adapter in NetworkService.GetWirelessAdapters()) { Dispatcher.Invoke(() => Adapters.Add(adapter)); } }); }

缓存机制：将常用网卡的GUID保存到本地配置文件：

{ "DefaultAdapter": "{c33b9d21-b6e2-417e-950e-0ca2d2f9da42}", "LastUsedTime": "2023-12-20T14:30:00" }

极简模式：通过--fast参数跳过所有状态检查，直接执行操作：

if (options.FastMode) { Process.Start("netsh", $"interface set interface \"{adapterName}\" admin=disable"); Environment.Exit(0); // 立即退出 }

8. 项目打包与分发

最后，我们需要将项目打包成用户友好的形式：

发布为单文件应用：

dotnet publish -c Release -r win-x64 -p:PublishSingleFile=true

添加快捷方式生成功能：

void CreateShortcut() { var shell = new WshShell(); var shortcut = (IWshShortcut)shell.CreateShortcut( Path.Combine(Environment.GetFolderPath( Environment.SpecialFolder.Desktop), "禁用Wi-Fi.lnk")); shortcut.TargetPath = Assembly.GetEntryAssembly().Location; shortcut.Arguments = "--disable --fast"; shortcut.WorkingDirectory = AppContext.BaseDirectory; shortcut.Save(); }

添加自动更新检查（可选）：

async Task CheckForUpdates() { using var client = new HttpClient(); var latest = await client.GetStringAsync( "https://api.github.com/repos/yourname/wifi-manager/releases/latest"); var remoteVer = JObject.Parse(latest)["tag_name"].ToString(); if (remoteVer != Assembly.GetEntryAssembly().GetName().Version.ToString()) { // 提示用户更新 } }

查看全文

http://www.jsqmd.com/news/556731/