TcpClient.ReceiveBufferSize Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví velikost vyrovnávací paměti příjmu.
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 IntegerHodnota vlastnosti
Velikost vyrovnávací paměti příjmu v bajtech. Výchozí hodnota je 8192 bajtů.
Výjimky
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ámkách k poznámkám k platformě.
Příklady
Následující příklad kódu nastaví a získá velikost vyrovnávací paměti příjmu.
// 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 pro příjem pro každou operaci čtení. Tato vlastnost ve skutečnosti manipuluje s místem vyrovnávací paměti sítě přidělenou pro příjem příchozích dat.
Vyrovnávací paměť sítě by měla být alespoň tak velká jako vyrovnávací paměť vaší aplikace, aby byla při volání NetworkStream.Read metody k dispozici požadovaná data.
ReceiveBufferSize Tuto velikost můžete nastavit pomocí vlastnosti. Pokud vaše aplikace přijímá hromadná data, měli byste předat Read metodu velmi velké vyrovnávací paměti aplikace.
Pokud je vyrovnávací paměť sítě menší než množství dat, která v Read metodě požadujete, nebudete moci načíst požadované množství dat v jedné operaci čtení. To způsobuje režii dalších volání metody Read .
