SerialPort.GetPortNames Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает массив имен последовательных портов для текущего компьютера.
public:
static cli::array <System::String ^> ^ GetPortNames();
public static string[] GetPortNames();
static member GetPortNames : unit -> string[]
Public Shared Function GetPortNames () As String()
Возвращаемое значение
Массив имен последовательных портов для текущего компьютера.
Исключения
Не удалось запросить имена последовательных портов.
Примеры
В следующем примере кода метод используется GetPortNames для отображения имен последовательного порта в консоли.
using System;
using System.IO.Ports;
namespace SerialPortExample
{
class SerialPortExample
{
public static void Main()
{
// Get a list of serial port names.
string[] ports = SerialPort.GetPortNames();
Console.WriteLine("The following serial ports were found:");
// Display each port name to the console.
foreach(string port in ports)
{
Console.WriteLine(port);
}
Console.ReadLine();
}
}
}
' Insert this code into a new VB Console application project, and set the
' startup object to Sub Main.
Imports System.IO.Ports
Module SerialPortExample
Sub Main()
' Get a list of serial port names.
Dim ports As String() = SerialPort.GetPortNames()
Console.WriteLine("The following serial ports were found:")
' Display each port name to the console.
Dim port As String
For Each port In ports
Console.WriteLine(port)
Next port
Console.ReadLine()
End Sub
End Module
Комментарии
Порядок имен портов, возвращаемых из GetPortNames нее, не указан.
GetPortNames Используйте метод для запроса текущего компьютера для списка допустимых имен последовательных портов. Например, этот метод можно использовать для определения того, являются ли COM1 и COM2 допустимыми последовательные порты для текущего компьютера.
Имена портов получены из системного реестра (например, HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\SERIALCOMM). Если реестр содержит устаревшие или неверные данные, GetPortNames метод вернет неверные данные.