TcpClient.ReceiveBufferSize Свойство

Определение

Пространство имен:

System.Net.Sockets

Сборки:

netstandard.dll, 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 " + 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)