次の方法で共有


TcpClient.ReceiveBufferSize プロパティ

定義

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

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

プロパティ値

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

例外

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

または

.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

適用対象

こちらもご覧ください