TcpClient.SendBufferSize-Eigenschaft

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

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

Syntax

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

value = instance.SendBufferSize

instance.SendBufferSize = value

public int SendBufferSize { get; set; }

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

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

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

public function get SendBufferSize () : int

public function set SendBufferSize (value : int)

Eigenschaftenwert

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

Hinweise

Die SendBufferSize-Eigenschaft ruft die Anzahl der Bytes ab, die bei jedem Aufruf der NetworkStream.Write-Methode gesendet werden soll, oder legt diese fest. Diese Eigenschaft verändert den Netzwerkpufferplatz, der für Sendevorgänge zugewiesen ist.

Der Netzwerkpuffer sollte mindestens so groß sein wie der Anwendungspuffer, um sicherzustellen, dass die gewünschten Daten in einem Vorgang gespeichert und gesendet werden können. Sie können die Größe mit der SendBufferSize-Eigenschaft festlegen. Wenn die Anwendung große Datenmengen senden soll, empfiehlt es sich, an die Write-Methode einen sehr großen Anwendungspuffer zu übergeben.

Wenn der Netzwerkpuffer kleiner als die Datenmenge ist, die Sie in der Write-Methode bereitstellen, werden für jeden Aufruf der Write-Methode mehrere Netzwerksendevorgänge ausgeführt. Sie können einen größeren Datendurchsatz erzielen, wenn Sie sicherstellen, dass der Netzwerkpuffer mindestens so groß wie der Anwendungspuffer ist.

Beispiel

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

'Sets the send buffer size using the SendBufferSize public property.
tcpClient.SendBufferSize = 1024

' Gets the send buffer size using the SendBufferSize public property.
If tcpClient.SendBufferSize = 1024 Then
   Console.WriteLine(("The send buffer was successfully set to " + tcpClient.SendBufferSize.ToString()))
End If

// Sets the send buffer size using the SendBufferSize public property.
tcpClient.SendBufferSize = 1024;

// Gets the send buffer size using the SendBufferSize public property.
if (tcpClient.SendBufferSize == 1024)
    Console.WriteLine ("The send buffer was successfully set to " + tcpClient.SendBufferSize.ToString ());

//sets the send buffer size using the SendBufferSize public property.
tcpClient->SendBufferSize = 1024;

// gets the send buffer size using the SendBufferSize public property.
if ( tcpClient->SendBufferSize == 1024 )
      Console::WriteLine( "The send buffer was successfully set to {0}", tcpClient->SendBufferSize );

// Sets the send buffer size using the SendBufferSize public property.
tcpClient.set_SendBufferSize(1024);

// Gets the send buffer size using the SendBufferSize public property.
if (tcpClient.get_SendBufferSize() == 1024) {
    Console.WriteLine("The send buffer was successfully set to "
        + ((Int32)tcpClient.get_SendBufferSize()).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
TcpClient.ReceiveBufferSize-Eigenschaft
Write