TcpClient.ReceiveBufferSize Eigenschaft

  • Referenz

Definition

Namespace:
System.Net.Sockets
Assembly:
System.Net.Sockets.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Quelle:
TCPClient.cs
Quelle:
TCPClient.cs
Quelle:
TCPClient.cs

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

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

Eigenschaftswert

Int32

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

Ausnahmen

SocketException

Beim Festlegen der Puffergröße ist ein Fehler aufgetreten.

- oder -

In .NET Compact Framework-Anwendungen können Sie diese Eigenschaft nicht festlegen. Eine Problemumgehung finden Sie im Abschnitt Hinweise unter dem Hinweis zur Plattform.

Beispiele

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

Hinweise

Die ReceiveBufferSize -Eigenschaft ruft die Anzahl der Bytes ab, die Sie für jeden Lesevorgang im Empfangspuffer speichern möchten, oder legt diese fest. Diese Eigenschaft bearbeitet tatsächlich den Netzwerkpufferspeicherplatz, der für den Empfang eingehender Daten zugewiesen ist.

Ihr Netzwerkpuffer sollte mindestens so groß wie Ihr Anwendungspuffer sein, um sicherzustellen, dass die gewünschten Daten verfügbar sind, wenn Sie die NetworkStream.Read -Methode aufrufen. Verwenden Sie die ReceiveBufferSize -Eigenschaft, um diese Größe festzulegen. Wenn Ihre Anwendung Massendaten empfängt, sollten Sie der Read Methode einen sehr großen Anwendungspuffer übergeben.

Wenn der Netzwerkpuffer kleiner als die Datenmenge ist, die Sie in der Read -Methode anfordern, können Sie nicht die gewünschte Datenmenge in einem Lesevorgang abrufen. Dies verursacht den Mehraufwand für zusätzliche Aufrufe der Read -Methode.

Gilt für:

Weitere Informationen