SerialPort.GetPortNames Método

Definición

Espacio de nombres:

System.IO.Ports

Ensamblado:

System.IO.Ports.dll

Paquete:

System.IO.Ports v8.0.0

Source:

SerialPort.Win32.cs

Obtiene una matriz con los nombres de los puertos serie del equipo actual.

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

public static string[] GetPortNames ();

static member GetPortNames : unit -> string[]

Public Shared Function GetPortNames () As String()

Devoluciones

String[]

Una matriz con los nombres de los puertos serie del equipo actual.

Excepciones

Win32Exception

No se pudieron consultar los nombres de puerto serie.

Ejemplos

En el ejemplo de código siguiente se usa el GetPortNames método para mostrar los nombres de puerto serie en la consola.

#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

Comentarios

No se especifica el orden de los nombres de puerto devueltos de GetPortNames .

Use el GetPortNames método para consultar el equipo actual para obtener una lista de nombres de puerto serie válidos. Por ejemplo, puede usar este método para determinar si COM1 y COM2 son puertos serie válidos para el equipo actual.

Los nombres de puerto se obtienen del registro del sistema (por ejemplo, HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\SERIALCOMM). Si el registro contiene datos obsoletos o incorrectos, el GetPortNames método devolverá datos incorrectos.