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

Размер приемного буфера (в байтах). Значение по умолчанию — 8192 байт.

Исключения

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 методе , вы не сможете получить нужный объем данных за одну операцию чтения. Это влечет за собой дополнительные вызовы Read метода .

См. также раздел

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