TcpClient.ReceiveBufferSize プロパティ

定義

名前空間:

System.Net.Sockets

アセンブリ:

System.Net.Sockets.dll

ソース:

TCPClient.cs

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

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

public int ReceiveBufferSize { get; set; }

member this.ReceiveBufferSize : int with get, set

Public Property ReceiveBufferSize As Integer

プロパティ値

Int32

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

例外

SocketException

バッファー サイズの設定中にエラーが発生しました。

または

.NET Compact Framework アプリケーションでは、このプロパティは設定できません。 代替手段については、「解説」の「プラットフォームメモ」を参照してください。

例

次のコード例では、受信バッファー サイズを設定して取得します。

// 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 {0}", tcpClient->ReceiveBufferSize );

// 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 ());

' 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

注釈

プロパティは ReceiveBufferSize 、読み取り操作ごとに受信バッファーに格納する必要があるバイト数を取得または設定します。 このプロパティは、受信データを受信するために割り当てられたネットワーク バッファー領域を実際に操作します。

メソッドを呼び出 NetworkStream.Read すときに目的のデータを確実に使用できるように、ネットワーク バッファーはアプリケーション バッファーと同じ大きさにする必要があります。 このサイズを設定するには、 ReceiveBufferSize プロパティを使用します。 アプリケーションが一括データを受信する場合は、 メソッドに非常に Read 大きなアプリケーション バッファーを渡す必要があります。

ネットワーク バッファーが メソッドで Read 要求したデータの量よりも小さい場合、1 回の読み取り操作で目的の量のデータを取得することはできません。 これにより、 メソッドに対する追加の呼び出しのオーバーヘッドが発生します Read 。

こちらもご覧ください

• SendBufferSize
• Read(Byte[], Int32, Int32)