SerialPort.GetPortNames Método

Definição

Namespace:

System.IO.Ports

Assembly:

System.IO.Ports.dll

Pacote:

System.IO.Ports v8.0.0

Origem:

SerialPort.Win32.cs

Obtém uma matriz de nomes de porta de série para o computador atual.

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

public static string[] GetPortNames ();

static member GetPortNames : unit -> string[]

Public Shared Function GetPortNames () As String()

Retornos

String[]

Uma matriz de nomes de porta serial para o computador atual.

Exceções

Win32Exception

Não foi possível consultar os nomes de porta serial.

Exemplos

O exemplo de código a seguir usa o GetPortNames método para exibir nomes de porta serial no console.

#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

Comentários

A ordem dos nomes de porta retornados de GetPortNames não é especificada.

Use o GetPortNames método para consultar o computador atual para obter uma lista de nomes de porta serial válidos. Por exemplo, você pode usar esse método para determinar se COM1 e COM2 são portas serial válidas para o computador atual.

Os nomes de porta são obtidos do registro do sistema (por exemplo, HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\SERIALCOMM). Se o registro contiver dados obsoletos ou incorretos, o GetPortNames método retornará dados incorretos.