SerialPort.GetPortNames Methode

Definition

Ruft ein Array der seriellen Anschlussnamen für den aktuellen Computer ab.

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

Gibt zurück

String[]

Ein Array der seriellen Anschlussnamen für den aktuellen Computer.

Ausnahmen

Die seriellen Anschlussnamen konnten nicht abgefragt werden.

Beispiele

Im folgenden Codebeispiel wird die GetPortNames -Methode verwendet, um namen serieller Ports in der Konsole anzuzeigen.

#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

Hinweise

Die Reihenfolge der Portnamen, die von zurückgegeben werden, GetPortNames wird nicht angegeben.

Verwenden Sie die GetPortNames -Methode, um den aktuellen Computer nach einer Liste gültiger Serieller Anschlussnamen abzufragen. Mit dieser Methode können Sie beispielsweise bestimmen, ob COM1 und COM2 gültige serielle Anschlüsse für den aktuellen Computer sind.

Die Portnamen werden aus der Systemregistrierung abgerufen (z. B. HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\SERIALCOMM). Wenn die Registrierung veraltete oder anderweitig falsche Daten enthält, gibt die GetPortNames Methode falsche Daten zurück.

Gilt für