SerialPort.GetPortNames Metodo

Definizione

Spazio dei nomi:

System.IO.Ports

Assembly:

System.IO.Ports.dll

Pacchetto:

System.IO.Ports v8.0.0

Origine:

SerialPort.Win32.cs

Ottiene una matrice di nomi di porta seriale per il computer corrente.

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

public static string[] GetPortNames ();

static member GetPortNames : unit -> string[]

Public Shared Function GetPortNames () As String()

Restituisce

String[]

Matrice di nomi di porta seriale per il computer corrente.

Eccezioni

Win32Exception

Impossibile eseguire una query nei nomi delle porte seriali.

Esempio

Nell'esempio di codice seguente viene utilizzato il GetPortNames metodo per visualizzare i nomi delle porte seriali nella 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

Commenti

L'ordine dei nomi di porta restituiti da GetPortNames non è specificato.

Utilizzare il GetPortNames metodo per eseguire una query sul computer corrente per un elenco di nomi di porta seriale validi. Ad esempio, è possibile utilizzare questo metodo per determinare se COM1 e COM2 sono porte seriali valide per il computer corrente.

I nomi delle porte vengono ottenuti dal Registro di sistema, ad esempio HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\SERIALCOMM). Se il Registro di sistema contiene dati non aggiornati o altrimenti non corretti, il GetPortNames metodo restituirà dati non corretti.