TcpClient.ReceiveBufferSize Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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, setPublic Property ReceiveBufferSize As IntegerValor de propiedad
Tamaño del búfer de recepción, en bytes. El valor predeterminado es 8192 bytes.
Excepciones
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 .
