SerialPort.GetPortNames Méthode

Définition

Espace de noms:

System.IO.Ports

Assembly:

System.IO.Ports.dll

Paquet:

System.IO.Ports v8.0.0

Source:

SerialPort.Win32.cs

Obtient un tableau de noms de ports série pour l'ordinateur actuel.

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

public static string[] GetPortNames ();

static member GetPortNames : unit -> string[]

Public Shared Function GetPortNames () As String()

Retours

String[]

Tableau de noms de ports série pour l'ordinateur actuel.

Exceptions

Win32Exception

Les noms de ports série n'ont pas pu être interrogés.

Exemples

L’exemple de code suivant utilise la méthode pour afficher les GetPortNames noms de port série dans la 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

Remarques

L’ordre des noms de port retournés à partir de GetPortNames n’est pas spécifié.

Utilisez la GetPortNames méthode pour interroger l’ordinateur actuel pour obtenir une liste de noms de ports série valides. Par exemple, vous pouvez utiliser cette méthode pour déterminer si COM1 et COM2 sont des ports série valides pour l’ordinateur actuel.

Les noms de port sont obtenus à partir du registre système (par exemple, HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\SERIALCOMM). Si le registre contient des données obsolètes ou incorrectes, la GetPortNames méthode retourne des données incorrectes.