SerialPort.ReadBufferSize プロパティ

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

SerialPort.ReadBufferSize プロパティ

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

SerialPort の入力バッファのサイズを取得または設定します。

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

Visual Basic (宣言)

Public Property ReadBufferSize As
 Integer

Visual Basic (使用法)

Dim instance As SerialPort
Dim value As Integer

value = instance.ReadBufferSize

instance.ReadBufferSize = value

C#

public int ReadBufferSize { get;
 set; }

C++

public:
property int ReadBufferSize {
    int get ();
    void set (int value);
}

J#

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

/** @property */
public void set_ReadBufferSize (int
 value)

JScript

public function get ReadBufferSize
 () : int

public function set ReadBufferSize
 (value : int)

プロパティ値
バッファ サイズ。既定値は、4096 です。

例外

例外の種類	条件
ArgumentOutOfRangeException	ReadBufferSize 値が 0 以下の値に設定されています。
InvalidOperationException	ストリームが開いているときに、ReadBufferSize プロパティが設定されました。
IOException	ReadBufferSize プロパティに奇数の整数値が設定されました。

解説

ReadBufferSize プロパティは、4096 未満の値を無視します。

メモ
BytesToRead プロパティは、ReadBufferSize プロパティよりも大きい値を返す場合があります。これは、ReadBufferSize プロパティが Windows によって作成されたバッファだけを表すのに対し、BytesToRead プロパティは Windows によって作成されたバッファだけでなく、SerialPort のバッファも表すためです。

Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows CE プラットフォームメモ : Windows CE の場合、バッファ サイズを渡すことはシリアル ドライバの必須事項ではなく、推奨事項に過ぎません。シリアル ドライバでは、推奨バッファ サイズが無視される場合があります。

プラットフォーム

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