TcpClient.ReceiveBufferSize Vlastnost

  • Reference

Definice

Obor názvů:
System.Net.Sockets
Sestavení:
System.Net.Sockets.dll
Sestavení:
System.dll
Sestavení:
netstandard.dll
Zdroj:
TCPClient.cs
Zdroj:
TCPClient.cs
Zdroj:
TCPClient.cs

Získá nebo nastaví velikost vyrovnávací paměti pro příjem.

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

Hodnota vlastnosti

Int32

Velikost vyrovnávací paměti pro příjem v bajtech. Výchozí hodnota je 8192 bajtů.

Výjimky

SocketException

Při nastavování velikosti vyrovnávací paměti došlo k chybě.

-nebo-

V aplikacích .NET Compact Framework nelze nastavit tuto vlastnost. Alternativní řešení najdete v poznámce k platformě v poznámkách.

Příklady

Následující příklad kódu nastaví a získá velikost vyrovnávací paměti pro příjem.

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

Poznámky

Vlastnost ReceiveBufferSize získá nebo nastaví počet bajtů, které očekáváte uložit do vyrovnávací paměti příjmu pro každou operaci čtení. Tato vlastnost ve skutečnosti manipuluje s prostorem síťové vyrovnávací paměti přidělenou pro příjem příchozích dat.

Síťová vyrovnávací paměť by měla být alespoň stejně velká jako vyrovnávací paměť aplikace, aby se zajistilo, že při volání NetworkStream.Read metody budou k dispozici požadovaná data. ReceiveBufferSize K nastavení této velikosti použijte vlastnost . Pokud bude vaše aplikace přijímat hromadná data, měli byste metodě předat Read velmi velkou vyrovnávací paměť aplikace.

Pokud je síťová vyrovnávací paměť menší než množství dat, které požadujete v Read metodě, nebudete moct načíst požadované množství dat v jedné operaci čtení. To způsobuje režii dalších volání Read metody.

Platí pro

Viz také