TcpClient.ReceiveBufferSize Egenskap

Definition

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

Hämtar eller anger storleken på mottagningsbufferten.

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

Storleken på mottagningsbufferten i byte. Standardvärdet är 8 192 byte.

Undantag

SocketException

Ett fel uppstod när buffertstorleken skulle anges.

-eller-

I .NET Compact Framework-program kan du inte ange den här egenskapen. En lösning finns i Plattformsanteckning i Kommentarer.

Exempel

Följande kodexempel anger och hämtar buffertstorleken för mottagningen.

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

Kommentarer

Egenskapen ReceiveBufferSize hämtar eller anger antalet byte som du förväntar dig att lagra i mottagningsbufferten för varje läsåtgärd. Den här egenskapen ändrar faktiskt det nätverksbuffertutrymme som allokerats för att ta emot inkommande data.

Nätverksbufferten bör vara minst lika stor som programbufferten för att säkerställa att önskade data blir tillgängliga när du anropar NetworkStream.Read metoden. Använd egenskapen ReceiveBufferSize för att ange den här storleken. Om ditt program tar emot massdata bör du skicka Read metoden till en mycket stor programbuffert.

Om nätverksbufferten är mindre än mängden data som du begär i Read metoden kan du inte hämta önskad mängd data i en läsåtgärd. Detta medför kostnader för ytterligare anrop till Read metoden.

Gäller för

Se även