Freigeben über


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 serielle Portnamen für die 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 von zurückgegebenen GetPortNames Portnamen ist nicht angegeben.

Verwenden Sie die GetPortNames -Methode, um den aktuellen Computer nach einer Liste gültiger serieller Portnamen abzufragen. Mit dieser Methode können Sie beispielsweise ermitteln, ob COM1 und COM2 für den aktuellen Computer gültige serielle Ports 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: