Socket.ReceiveBufferSize Egenskap

Definition

Namnområde:
System.Net.Sockets
Sammansättningar:
System.dll, System.Net.Sockets.dll
Sammansättning:
System.dll
Sammansättning:
System.Net.Sockets.dll
Sammansättning:
netstandard.dll

Hämtar eller anger ett värde som anger storleken på mottagningsbufferten för 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

Egenskapsvärde

Int32

En Int32 som innehåller storleken, i byte, på mottagningsbufferten. Standardvärdet beror på operativsystemet.

Undantag

SocketException

Ett fel uppstod vid försök att komma åt socketen.

ObjectDisposedException

Har Socket stängts.

ArgumentOutOfRangeException

Värdet som anges för en angiven åtgärd är mindre än 0.

Exempel

Följande kodexempel visar hur egenskapen används ReceiveBufferSize .

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("");
}

Kommentarer

En större buffertstorlek minskar potentiellt antalet tomma bekräftelser (TCP-paket utan datadel), men kan också fördröja igenkänningen av anslutningssvårigheter. Överväg att öka buffertstorleken om du överför stora filer, eller om du använder en anslutning med hög bandbredd och långa svarstider (till exempel en leverantör av satellitbredband.)

Gäller för