SerialPort.GetPortNames Metoda

Definice

Obor názvů:

System.IO.Ports

Sestavení:

System.IO.Ports.dll

Balíček:

System.IO.Ports v8.0.0

Zdroj:

SerialPort.Win32.cs

Získá pole názvů sériových portů pro aktuální počítač.

public:
 static cli::array <System::String ^> ^ GetPortNames();

public static string[] GetPortNames ();

static member GetPortNames : unit -> string[]

Public Shared Function GetPortNames () As String()

Návraty

String[]

Pole názvů sériových portů pro aktuální počítač.

Výjimky

Win32Exception

Názvy sériových portů nelze dotazovat.

Příklady

Následující příklad kódu používá metodu GetPortNames k zobrazení názvů sériových portů do konzoly.

#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

Poznámky

Pořadí názvů portů vrácených z GetPortNames není zadáno.

Použijte metodu GetPortNames k dotazování aktuálního počítače na seznam platných názvů sériových portů. Tuto metodu můžete například použít k určení, zda jsou pro aktuální počítač platné sériové porty COM1 a COM2.

Názvy portů se získávají ze systémového registru (například HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\SERIALCOMM). Pokud registr obsahuje zastaralá nebo jinak nesprávná data, GetPortNames vrátí metoda nesprávná data.