TcpClient.ReceiveBufferSize Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Property ReceiveBufferSize As IntegerEigenschaftswert
Die Größe des Empfangspuffers in Bytes. Der Standardwert ist 8192 Bytes.
Ausnahmen
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.
