SerialPort.BytesToRead プロパティ

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

SerialPort.BytesToRead プロパティ

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

受信バッファ内のデータのバイト数を取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 BytesToRead As Integer

Visual Basic (使用法)

Dim instance As SerialPort
Dim value As Integer

value = instance.BytesToRead

C#

public int BytesToRead { get;
 }

C++

public:
property int BytesToRead {
    int get ();
}

J#

/** @property */
public int get_BytesToRead ()

JScript

public function get BytesToRead
 () : int

プロパティ値
受信バッファ内のデータのバイト数。

例外

例外の種類	条件
IOException	ポートが無効状態です。
InvalidOperationException	ストリームが閉じられました。これは、Open メソッドが呼び出されていないか、Close メソッドが呼び出されたことが原因で発生する場合があります。

解説

受信バッファには、シリアル ドライバの受信バッファと、SerialPort オブジェクト自体の内部バッファが含まれます。

メモ
BytesToRead プロパティは、ReadBufferSize プロパティよりも大きい値を返す場合があります。これは、ReadBufferSize プロパティが Windows によって作成されたバッファだけを表すのに対し、BytesToRead プロパティは Windows によって作成されたバッファだけでなく、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 名前空間