SerialPort.GetPortNames Метод

Определение

Получает массив имен последовательных портов для текущего компьютера.Gets an array of serial port names for the current computer.

public:
 static cli::array <System::String ^> ^ GetPortNames();
public static string[] GetPortNames ();
static member GetPortNames : unit -> string[]
Public Shared Function GetPortNames () As String()

Возвраты

String[]

Массив имен последовательных портов для текущего компьютера.An array of serial port names for the current computer.

Исключения

Не удалось выполнить запрос имен последовательных портов.The serial port names could not be queried.

Примеры

В следующем примере кода используется GetPortNames метод для вывода имен последовательных портов на консоль.The following code example uses the GetPortNames method to display serial port names to the console.

#using <System.dll>

using namespace System;
using namespace System::IO::Ports;
using namespace System::ComponentModel;

void main()
{
    array<String^>^ serialPorts = nullptr;
    try
    {
        // Get a list of serial port names.
        serialPorts = SerialPort::GetPortNames();
    }
    catch (Win32Exception^ ex)
    {
        Console::WriteLine(ex->Message);
    }

    Console::WriteLine("The following serial ports were found:");

    // Display each port name to the console.
    for each(String^ port in serialPorts)
    {
        Console::WriteLine(port);
    }
}

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 , не указан.The order of port names returned from GetPortNames is not specified.

GetPortNames Используйте метод для запроса к текущему компьютеру списка допустимых имен последовательных портов.Use the GetPortNames method to query the current computer for a list of valid serial port names. Например, с помощью этого метода можно определить, являются ли COM1 и COM2 допустимыми последовательными портами для текущего компьютера.For example, you can use this method to determine whether COM1 and COM2 are valid serial ports for the current computer.

Имена портов извлекаются из системного реестра (например, HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\SERIALCOMM).The port names are obtained from the system registry (for example, HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\SERIALCOMM). Если реестр содержит устаревшие или иным образом неправильные данные GetPortNames , метод возвратит неверные данные.If the registry contains stale or otherwise incorrect data then the GetPortNames method will return incorrect data.

Применяется к