SerialPort.GetPortNames メソッド

  • リファレンス

定義

名前空間:
System.IO.Ports
アセンブリ:
System.IO.Ports.dll
アセンブリ:
System.dll
パッケージ:
System.IO.Ports v6.0.0
パッケージ:
System.IO.Ports v7.0.0
パッケージ:
System.IO.Ports v8.0.0
パッケージ:
System.IO.Ports v9.0.0-preview.2.24128.5
ソース:
SerialPort.Win32.cs
ソース:
SerialPort.Win32.cs
ソース:
SerialPort.Win32.cs

現在のコンピューターのシリアル ポート名の配列を取得します。

public:
 static cli::array <System::String ^> ^ GetPortNames();
public static string[] GetPortNames ();
static member GetPortNames : unit -> string[]
Public Shared Function GetPortNames () As String()

戻り値

String[]

現在のコンピューターのシリアル ポート名の配列。

例外

Win32Exception

シリアル ポート名を照会できませんでした。

例

次のコード例では、 メソッドを GetPortNames 使用してシリアル ポート名をコンソールに表示します。

#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

注釈

から GetPortNames 返されるポート名の順序が指定されていません。

メソッドを GetPortNames 使用して、有効なシリアル ポート名の一覧を現在のコンピューターに照会します。 たとえば、このメソッドを使用して、COM1 と COM2 が現在のコンピューターの有効なシリアル ポートであるかどうかを判断できます。

ポート名は、システム レジストリ (たとえば、HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\SERIALCOMM)) から取得されます。 レジストリに古いデータまたは正しくないデータが含まれている場合、メソッドは正しくないデータを GetPortNames 返します。

適用対象