SerialPort.GetPortNames Methode
Definition
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 von seriellen Portnamen 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
Ein Array von seriellen Portnamen für den aktuellen Computer.
Ausnahmen
Die Namen des seriellen Ports konnten nicht abgefragt werden.
Beispiele
Im folgenden Codebeispiel wird die GetPortNames Methode verwendet, um serielle Portnamen in der Konsole anzuzeigen.
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 zurückgegebenen GetPortNames Portnamen ist nicht angegeben.
Verwenden Sie die GetPortNames Methode, um den aktuellen Computer nach einer Liste der gültigen Namen des seriellen Ports abzufragen. Mit dieser Methode können Sie beispielsweise ermitteln, ob COM1 und COM2 gültige serielle Ports 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.
