SerialPort.PortName プロパティ

.NET Framework クラス ライブラリ リファレンス

SerialPort.PortName プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

通信用のポートを取得または設定します。このポートには、使用可能なすべての COM ポートが含まれますが、これに限定されるわけではありません。

名前空間: System.IO.Ports
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Property PortName As
 String

Visual Basic (使用法)

Dim instance As SerialPort
Dim value As String

value = instance.PortName

instance.PortName = value

C#

public string PortName { get;
 set; }

C++

public:
property String^ PortName {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_PortName ()

/** @property */
public void set_PortName (String value)

JScript

public function get PortName
 () : String

public function set PortName
 (value : String)

プロパティ値
通信ポート。既定値は COM1 です。

例外

例外の種類	条件
ArgumentException	PortName プロパティに長さ 0 の値が設定されました。 または PortName プロパティに、"\\" で始まる値が設定されました。 または ポート名が有効ではありません。
ArgumentNullException	PortName プロパティが null 参照 (Visual Basic では Nothing) に設定されました。
InvalidOperationException	指定したポートは開いています。

解説

有効なポート名の一覧は、GetPortNames メソッドを使用して取得できます。

使用例

SerialPort クラスを使用して、ヌル モデム ケーブルで接続された 2 台のコンピュータで 2 人のユーザーがチャットできるようにするための方法を次のコード例に示します。この例では、ユーザーはチャットを行う前にポート設定とユーザー名の入力を求められます。このコード例は、SerialPort クラスのトピックで取り上げている、コード例の一部分です。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
SerialPort クラス
SerialPort メンバ
System.IO.Ports 名前空間