Socket.ReceiveBufferSize Proprietà

Definizione

Spazio dei nomi:

System.Net.Sockets

Assembly:

netstandard.dll, System.Net.Sockets.dll

Origine:

Socket.cs

Ottiene o imposta un valore che specifica le dimensioni del buffer di ricezione dell'oggetto Socket.

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

Valore della proprietà

Int32

Oggetto Int32 contenente le dimensioni, in byte, del buffer di ricezione. Il valore predefinito dipende dal sistema operativo.

Eccezioni

SocketException

Si è verificato un errore durante il tentativo di accesso al socket.

ObjectDisposedException

L'oggetto Socket è stato chiuso.

ArgumentOutOfRangeException

Il valore specificato per un'operazione set è minore di 0.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso della ReceiveBufferSize proprietà .

static void ConfigureTcpSocket(Socket tcpSocket)
{
    // Don't allow another socket to bind to this port.
    tcpSocket.ExclusiveAddressUse = true;

    // The socket will linger for 10 seconds after
    // Socket.Close is called.
    tcpSocket.LingerState = new LingerOption (true, 10);

    // Disable the Nagle Algorithm for this tcp socket.
    tcpSocket.NoDelay = true;

    // Set the receive buffer size to 8k
    tcpSocket.ReceiveBufferSize = 8192;

    // Set the timeout for synchronous receive methods to
    // 1 second (1000 milliseconds.)
    tcpSocket.ReceiveTimeout = 1000;

    // Set the send buffer size to 8k.
    tcpSocket.SendBufferSize = 8192;

    // Set the timeout for synchronous send methods
    // to 1 second (1000 milliseconds.)
    tcpSocket.SendTimeout = 1000;

    // Set the Time To Live (TTL) to 42 router hops.
    tcpSocket.Ttl = 42;

    Console.WriteLine("Tcp Socket configured:");

    Console.WriteLine($"  ExclusiveAddressUse {tcpSocket.ExclusiveAddressUse}");

    Console.WriteLine($"  LingerState {tcpSocket.LingerState.Enabled}, {tcpSocket.LingerState.LingerTime}");

    Console.WriteLine($"  NoDelay {tcpSocket.NoDelay}");

    Console.WriteLine($"  ReceiveBufferSize {tcpSocket.ReceiveBufferSize}");

    Console.WriteLine($"  ReceiveTimeout {tcpSocket.ReceiveTimeout}");

    Console.WriteLine($"  SendBufferSize {tcpSocket.SendBufferSize}");

    Console.WriteLine($"  SendTimeout {tcpSocket.SendTimeout}");

    Console.WriteLine($"  Ttl {tcpSocket.Ttl}");

    Console.WriteLine($"  IsBound {tcpSocket.IsBound}");

    Console.WriteLine("");
}

Commenti

Una dimensione maggiore del buffer riduce potenzialmente il numero di riconoscimenti vuoti (pacchetti TCP senza parti di dati), ma potrebbe anche ritardare il riconoscimento delle difficoltà di connessione. Valutare la possibilità di aumentare le dimensioni del buffer se si trasferiscono file di grandi dimensioni o si usa una connessione a larghezza di banda elevata, ad alta latenza , ad esempio un provider di banda larga satellite.