SerialPort.GetPortNames Methode

Referenz

Definition

Namespace:: System.IO.Ports

Assembly:: System.IO.Ports.dll

Assembly:: System.dll

Paket:: System.IO.Ports v6.0.0

Paket:: System.IO.Ports v7.0.0

Paket:: System.IO.Ports v8.0.0

Paket:: System.IO.Ports v9.0.0-preview.2.24128.5

Quelle:: SerialPort.Win32.cs

Quelle:: SerialPort.Win32.cs

Quelle:: SerialPort.Win32.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Win32Exception

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:

Produkt	Versionen
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Teilen über