SerialPort.GetPortNames Metoda

Definicja

Przestrzeń nazw:

System.IO.Ports

Zestaw:

System.IO.Ports.dll

Pakiet:

System.IO.Ports v8.0.0

Źródło:

SerialPort.Win32.cs

Pobiera tablicę nazw portów szeregowych dla bieżącego komputera.

public:
 static cli::array <System::String ^> ^ GetPortNames();

public static string[] GetPortNames ();

static member GetPortNames : unit -> string[]

Public Shared Function GetPortNames () As String()

Zwraca

String[]

Tablica nazw portów szeregowych dla bieżącego komputera.

Wyjątki

Win32Exception

Nie można wykonywać zapytań o nazwy portów seryjnych.

Przykłady

W poniższym przykładzie kodu użyto GetPortNames metody do wyświetlania nazw portów szeregowych w konsoli programu .

#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

Uwagi

Nie określono kolejności nazw portów zwróconych z GetPortNames .

GetPortNames Użyj metody , aby wysłać zapytanie do bieżącego komputera, aby uzyskać listę prawidłowych nazw portów szeregowych. Można na przykład użyć tej metody, aby określić, czy COM1 i COM2 są prawidłowymi portami szeregowymi dla bieżącego komputera.

Nazwy portów są uzyskiwane z rejestru systemowego (na przykład HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\SERIALCOMM). Jeśli rejestr zawiera nieaktualne lub w inny sposób nieprawidłowe dane, GetPortNames metoda zwróci nieprawidłowe dane.