TcpClient.ReceiveBufferSize プロパティ

受信バッファのサイズを取得または設定します。

Public Property ReceiveBufferSize As Integer
[C#]
public int ReceiveBufferSize {get; set;}
[C++]
public: __property int get_ReceiveBufferSize();public: __property void set_ReceiveBufferSize(int);
[JScript]
public function get ReceiveBufferSize() : int;public function set ReceiveBufferSize(int);

プロパティ値

受信バッファ サイズ (バイト単位)。既定値は 8192 バイトです。

解説

ReceiveBufferSize プロパティはユーザーがそれぞれの読み取り操作について受信バッファに格納するバイト数を取得または設定します。このプロパティは、ネットワーク バッファで受信データに割り当てられている場所を実際に操作します。

ネットワーク バッファは、少なくともアプリケーション バッファと同じくらいのサイズがなければなりません。これは、 NetworkStream.Read メソッドを呼び出すときに必要なデータを使用できるようにするためです。 ReceiveBufferSize プロパティを使用してこのサイズを設定します。アプリケーションが大量のデータを受信する場合は、 Read メソッドに大量のアプリケーション バッファを渡す必要があります。

ネットワーク バッファが Read メソッドに必要なデータ量よりも少ない場合は、必要な量のデータを 1 回の読み取り操作で取得することはできません。このため、 Read メソッドをさらに呼び出すというオーバーヘッドが生じることになります。

使用例

[Visual Basic, C#, C++] 受信バッファ サイズを設定および取得する例を次に示します。

 
' Sets the receive buffer size using the ReceiveBufferSize public property.
tcpClient.ReceiveBufferSize = 1024

' Gets the receive buffer size using the ReceiveBufferSize public property.
If tcpClient.ReceiveBufferSize = 1024 Then
   Console.WriteLine(("The receive buffer was successfully set to " + tcpClient.ReceiveBufferSize.ToString()))
End If

[C#] 
// Sets the receive buffer size using the ReceiveBufferSize public property.
tcpClient.ReceiveBufferSize = 1024;

// Gets the receive buffer size using the ReceiveBufferSize public property.
if (tcpClient.ReceiveBufferSize == 1024)
    Console.WriteLine ("The receive buffer was successfully set to " + tcpClient.ReceiveBufferSize.ToString ());


[C++] 
// sets the receive buffer size using the ReceiveBufferSize public property.
tcpClient->ReceiveBufferSize = 1024;
   
// gets the receive buffer size using the ReceiveBufferSize public property.
if (tcpClient->ReceiveBufferSize == 1024)
    Console::WriteLine(S"The receive buffer was successfully set to {0}", __box(tcpClient->ReceiveBufferSize));

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

TcpClient クラス | TcpClient メンバ | System.Net.Sockets 名前空間 | SendBufferSize | Read