在 C# WinForms 应用程序中，获取本机可用的串行端口（COM 端口）列表是一个常见需求，尤其是在开发与串口通信相关的应用程序时（如与 Arduino、PLC、传感器等设备通信）。Windows 会将串口设备注册为 `COMx`（例如 COM1、COM3、COM10 等），我们可以通过 .NET 提供的 `System.IO.Ports.SerialPort` 类来获取当前系统中所有可用的串行端口名称。 以下是完整的实现方法： ```csharp using System; using System.Windows.Forms; using System.IO.Ports; namespace ComPortListApp { public partial class Form1 : Form { public Form1() { InitializeComponent(); LoadComPorts(); } private void LoadComPorts() { // 获取本机所有可用的串行端口名称 string[] ports = SerialPort.GetPortNames(); // 显示到 ListBox 控件中 listBoxComPorts.Items.Clear(); foreach (string port in ports) { listBoxComPorts.Items.Add(port); } // 或者输出到 ComboBox // comboBoxComPorts.Items.AddRange(ports); // 如果没有找到端口，可以提示用户 if (ports.Length == 0) { MessageBox.Show("未检测到任何串行端口（COM端口）", "提示", MessageBoxButtons.OK, MessageBoxIcon.Information); } } } } ``` ### 解释： - `SerialPort.GetPortNames()`：这是 .NET Framework 提供的静态方法，用于获取当前计算机上所有可用的串行端口名称数组（如 `["COM1", "COM3", "COM4"]`）。 - `listBoxComPorts`：这是一个 `ListBox` 控件，用于显示检测到的 COM 端口。你也可以使用 `ComboBox`、`DataGridView` 或 `TextBox` 来展示。 - `LoadComPorts()` 方法在窗体加载时调用，自动列出所有 COM 口。 #### 设计器代码示例（可选）： 如果你使用的是 Visual Studio 的设计器，可以在 `InitializeComponent()` 中添加控件，或手动拖入一个 `ListBox`，命名为 `listBoxComPorts`。 --- ### 注意事项： - `GetPortNames()` 只能获取当前系统识别的串口设备名称，无法判断该端口是否正在被占用。 - 某些虚拟串口（如 USB 转串口适配器、蓝牙串口、虚拟 COM 口驱动）也会被列出。 - 如果你需要检测端口是否可用，必须尝试打开该端口（使用 `serialPort.Open()`），并捕获异常。 --- ### 扩展功能：检查某个 COM 端口是否被占用 ```csharp public bool IsPortAvailable(string portName) { try { using (var port = new SerialPort(portName)) { port.Open(); } return true; // 端口空闲 } catch (UnauthorizedAccessException) { return false; // 被占用 } catch (Exception) { return false; // 其他错误 } } ``` 你可以遍历所有端口并标记哪些是可用的。 --- ### 示例 UI 布局建议： - 一个 `ListBox` 显示 COM 端口 - 一个 `Button` 触发刷新 - 一个 `Label` 显示状态 ```csharp private void buttonRefresh_Click(object sender, EventArgs e) { LoadComPorts(); } ``` ---