SerialPort.GetPortNames Método

Definición

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

public static string[] GetPortNames ();

Devoluciones

String[]

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

Excepciones

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;
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();
        }
    }
}

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.

Se aplica a

Producto Versiones
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1