TcpClient.ReceiveBufferSize-Eigenschaft

Ruft die Größe des Empfangspuffers ab oder legt diese fest.

Namespace: System.Net.Sockets
Assembly: System (in system.dll)

Syntax

'Declaration
Public Property ReceiveBufferSize As Integer
'Usage
Dim instance As TcpClient
Dim value As Integer

value = instance.ReceiveBufferSize

instance.ReceiveBufferSize = value

public int ReceiveBufferSize { get; set; }

public:
property int ReceiveBufferSize {
    int get ();
    void set (int value);
}

/** @property */
public int get_ReceiveBufferSize ()

/** @property */
public void set_ReceiveBufferSize (int value)

public function get ReceiveBufferSize () : int

public function set ReceiveBufferSize (value : int)

Eigenschaftenwert

Die Größe des Empfangspuffers in Bytes. Der Standardwert ist 8192 Byte.

Ausnahmen

Hinweise

Die ReceiveBufferSize-Eigenschaft ruft die Anzahl der Bytes ab, die bei jedem Lesevorgang im Empfangspuffer gespeichert werden sollen, oder legt diese fest. Diese Eigenschaft verändert den Netzwerkpufferplatz, der für den Empfang eingehender Daten zugewiesen ist.

Der Netzwerkpuffer sollte mindestens so groß sein wie der Anwendungspuffer, um sicherzustellen, dass die gewünschten Daten bei einem Aufruf der NetworkStream.Read-Methode verfügbar sind. Sie können die Größe mit der ReceiveBufferSize-Eigenschaft festlegen. Wenn die Anwendung große Datenmengen empfangen soll, empfiehlt es sich, an die Read-Methode einen sehr großen Anwendungspuffer zu übergeben.

Wenn der Netzwerkpuffer kleiner als die in der Read-Methode angeforderte Datenmenge ist, können nicht sämtliche Daten in einem Lesevorgang abgerufen werden. Dies führt zu Mehrlast durch zusätzliche Aufrufe der Read-Methode.

Hinweis zu Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows CE: Diese Eigenschaft wird nur auf Sockets unterstützt, die auf Datagramme ausgerichtet sind, in Windows CE als SOCK_DGRAM angegeben. Die Standardempfangspuffergröße ist 32768 und kann nicht mit dieser Eigenschaft festgelegt werden.

Beispiel

Im folgenden Codebeispiel wird die Größe des Empfangspuffers festgelegt und abgerufen.

' 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

// 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 )
      Console::WriteLine( "The receive buffer was successfully set to {0}", tcpClient->ReceiveBufferSize );

// Sets the receive buffer size using the ReceiveBufferSize public
// property.
tcpClient.set_ReceiveBufferSize(1024);

// Gets the receive buffer size using the ReceiveBufferSize public
// property.
if (tcpClient.get_ReceiveBufferSize() == 1024) {
    Console.WriteLine("The receive buffer was successfully set to "
        + ((Int32)tcpClient.get_ReceiveBufferSize()).ToString());
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

TcpClient-Klasse
TcpClient-Member
System.Net.Sockets-Namespace
SendBufferSize
Read