TcpClient.SendBufferSize プロパティ

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

Public Property SendBufferSize As Integer
[C#]
public int SendBufferSize {get; set;}
[C++]
public: __property int get_SendBufferSize();public: __property void set_SendBufferSize(int);
[JScript]
public function get SendBufferSize() : int;public function set SendBufferSize(int);

プロパティ値

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

解説

SendBufferSize プロパティは、 NetworkStream.Write メソッドを呼び出すたびに送信するバイト数を取得または設定します。このプロパティは、ネットワーク バッファで送信操作に割り当てられている場所を実際に操作します。

ネットワーク バッファは、少なくともアプリケーション バッファと同じくらいのサイズがなければなりません。これは、1 回の操作で必要なデータが格納および送信されるようにするためです。 SendBufferSize プロパティを使用してこのサイズを設定します。アプリケーションが大量のデータを送信する場合は、 Write メソッドに大量のアプリケーション バッファを渡す必要があります。

ネットワーク バッファが Write メソッドに提供されたデータ量よりも少ない場合は、 Write メソッドを呼び出すたびに複数のネットワーク送信操作が実行されます。ネットワーク バッファが少なくともアプリケーション バッファと同じくらいのサイズであれば、大量のデータ スループットを実現できます。

使用例

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

 
'Sets the send buffer size using the SendBufferSize public property.
tcpClient.SendBufferSize = 1024

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

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

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


[C++] 
//sets the send buffer size using the SendBufferSize public property.
tcpClient->SendBufferSize = 1024;  

// gets the send buffer size using the SendBufferSize public property.
if (tcpClient->SendBufferSize == 1024)
    Console::WriteLine(S"The send buffer was successfully set to {0}", __box(tcpClient->SendBufferSize));

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