TcpClient.ReceiveBufferSize Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de grootte van de ontvangstbuffer op of stelt u deze in.
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 IntegerWaarde van eigenschap
De grootte van de ontvangstbuffer, in bytes. De standaardwaarde is 8192 bytes.
Uitzonderingen
Er is een fout opgetreden bij het instellen van de buffergrootte.
– of –
In .NET Compact Framework-toepassingen kunt u deze eigenschap niet instellen. Zie de platformnotitie in opmerkingen voor een tijdelijke oplossing.
Voorbeelden
In het volgende codevoorbeeld wordt de grootte van de ontvangstbuffer ingesteld en wordt de grootte van de ontvangstbuffer ophaalt.
// 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
Opmerkingen
De ReceiveBufferSize eigenschap haalt of stelt het aantal bytes in dat u verwacht op te slaan in de ontvangstbuffer voor elke leesbewerking. Met deze eigenschap wordt de netwerkbufferruimte bewerkt die is toegewezen voor het ontvangen van binnenkomende gegevens.
Uw netwerkbuffer moet minstens zo groot zijn als uw toepassingsbuffer om ervoor te zorgen dat de gewenste gegevens beschikbaar zijn wanneer u de NetworkStream.Read methode aanroept. Gebruik de ReceiveBufferSize eigenschap om deze grootte in te stellen. Als uw toepassing bulkgegevens ontvangt, moet u de Read methode doorgeven aan een zeer grote toepassingsbuffer.
Als de netwerkbuffer kleiner is dan de hoeveelheid gegevens die u in de Read methode aanvraagt, kunt u de gewenste hoeveelheid gegevens niet in één leesbewerking ophalen. Hierdoor wordt de overhead van extra aanroepen naar de Read methode in rekening gebracht.