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 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
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.
