TcpClient.ReceiveBufferSize Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Net.Sockets
Ensamblado:
System.Net.Sockets.dll
Ensamblado:
System.dll
Ensamblado:
netstandard.dll

Obtiene o establece el tamaño del búfer de recepción.

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 de propiedad

Int32

Tamaño del búfer de recepción, en bytes. El valor predeterminado es 8192 bytes.

Excepciones

SocketException

Se ha producido un error al establecer el tamaño del búfer.

O bien

En las aplicaciones .NET Compact Framework, no se puede establecer esta propiedad. Para obtener una solución alternativa, vea la Nota de la plataforma que se describe en Comentarios.

Ejemplos

En el ejemplo de código siguiente se establece y obtiene el tamaño del búfer de recepción.

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

Comentarios

La ReceiveBufferSize propiedad obtiene o establece el número de bytes que espera almacenar en el búfer de recepción para cada operación de lectura. Esta propiedad manipula realmente el espacio de búfer de red asignado para recibir datos entrantes.

El búfer de red debe ser al menos tan grande como el búfer de la aplicación para asegurarse de que los datos deseados estarán disponibles al llamar al NetworkStream.Read método . Utilice la ReceiveBufferSize propiedad para establecer este tamaño. Si la aplicación va a recibir datos masivos, debe pasar el Read método a un búfer de aplicación muy grande.

Si el búfer de red es menor que la cantidad de datos que solicita en el Read método , no podrá recuperar la cantidad deseada de datos en una operación de lectura. Esto conlleva la sobrecarga de llamadas adicionales al Read método .

Se aplica a

Consulte también