TcpClient.ReceiveBufferSize Propriedade

Definição

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Origem:

TCPClient.cs

Obtém ou define o tamanho do buffer de recepção.

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

Valor da propriedade

Int32

O tamanho do buffer de recepção, em bytes. O valor padrão é 8192 bytes.

Exceções

SocketException

Erro ao definir o tamanho do buffer.

- ou -

Em aplicativos do .NET Compact Framework, não é possível definir essa propriedade. Para obter uma solução alternativa, consulte Comentários sobre a plataforma em Comentários.

Exemplos

O exemplo de código a seguir define e obtém o tamanho do buffer de recebimento.

// 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

Comentários

A ReceiveBufferSize propriedade obtém ou define o número de bytes que você espera armazenar no buffer de recebimento para cada operação de leitura. Na verdade, essa propriedade manipula o espaço de buffer de rede alocado para receber dados de entrada.

O buffer de rede deve ser pelo menos tão grande quanto o buffer de aplicativo para garantir que os dados desejados estarão disponíveis quando você chamar o NetworkStream.Read método. Use a ReceiveBufferSize propriedade para definir esse tamanho. Se o aplicativo estiver recebendo dados em massa, você deverá passar o método para Read um buffer de aplicativo muito grande.

Se o buffer de rede for menor que a quantidade de dados solicitada no Read método , você não poderá recuperar a quantidade desejada de dados em uma operação de leitura. Isso incorre na sobrecarga de chamadas adicionais para o Read método .

Confira também

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