SerialPort.BaseStream プロパティ

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

SerialPort.BaseStream プロパティ

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

SerialPort オブジェクトの基になる Stream オブジェクトを取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 BaseStream As Stream

Visual Basic (使用法)

Dim instance As SerialPort
Dim value As Stream

value = instance.BaseStream

C#

public Stream BaseStream { get; }

C++

public:
property Stream^ BaseStream {
    Stream^ get ();
}

J#

/** @property */
public Stream get_BaseStream ()

JScript

public function get BaseStream
 () : Stream

プロパティ値
Stream オブジェクト。

例外

例外の種類	条件
InvalidOperationException	ストリームが閉じられました。これは、Open メソッドが呼び出されていないか、Close メソッドが呼び出されたことが原因で発生する場合があります。
NotSupportedException	ストリームが .NET Compact Framework アプリケーションにあるときに、次のいずれかのメソッドが呼び出されました。 BeginRead BeginWrite EndRead EndWrite .NET Compact Framework では、基本ストリームとの非同期モデルはサポートされません。

解説

このプロパティは、明示的な非同期 I/O 操作に使用したり、SerialPort オブジェクトを StreamWriter などの Stream ラッパー クラスに渡すために使用したりします。

オープン シリアル ポートの BaseStream プロパティは、抽象クラス Stream から派生したオブジェクトを返し、Stream クラスから継承したプロトタイプを使用して、読み取りメソッドと書き込みメソッド (BeginRead、BeginWrite、Read、ReadByte、Write、および WriteByte の各メソッド) を実装します。これらのメソッドは、ラップされたシリアル リソースを Stream ラッパー クラスに渡す場合に役立ちます。

ラップされたファイル ハンドルにはアクセスできないため、Length プロパティと Position プロパティは、サポートされていません。また、Seek メソッドと SetLength メソッドもサポートされていません。

プラットフォーム

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 名前空間