TcpClient.LingerState-Eigenschaft

Ruft Informationen über die Nachlaufzeit des Sockets ab oder legt diese fest.

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

Syntax

'Declaration
Public Property LingerState As LingerOption
'Usage
Dim instance As TcpClient
Dim value As LingerOption

value = instance.LingerState

instance.LingerState = value

public LingerOption LingerState { get; set; }

public:
property LingerOption^ LingerState {
    LingerOption^ get ();
    void set (LingerOption^ value);
}

/** @property */
public LingerOption get_LingerState ()

/** @property */
public void set_LingerState (LingerOption value)

public function get LingerState () : LingerOption

public function set LingerState (value : LingerOption)

Eigenschaftenwert

Ein LingerOption. In der Standardeinstellung ist der Nachlauf deaktiviert.

Hinweise

Diese Eigenschaft steuert den Zeitraum, in dem die TCP-Verbindung nach einem Aufruf von Close geöffnet bleibt, wenn noch weitere Daten zu senden sind. Wenn Sie die Write-Methode aufrufen, werden Daten im Netzwerkausgangspuffer abgelegt. Diese Eigenschaft kann verwendet werden, um sicherzustellen, dass die Daten an den Remotehost gesendet werden, bevor die Close-Methode die Verbindung beendet.

Sie können den Nachlauf aktivieren, indem Sie eine LingerOption mit den gewünschten Werten erstellen und diese Eigenschaft dann auf die LingerOption festlegen. Wenn die Enabled-Eigenschaft der LingerOption auf true festgelegt ist, werden die Daten mit einem Timeout von LingerOption.LingerTime Sekunden an das Netzwerk gesendet. Nach dem Senden der Daten bzw. nach Ablauf des Timeouts wird die Verbindung geschlossen, und alle nicht gesendeten Daten gehen verloren. Wenn die Enabled-Eigenschaft der LingerOption auf false festgelegt ist, wird die Verbindung nach einem Aufruf der Close-Methode sofort beendet, selbst wenn weitere Daten zu senden sind.

Beispiel

Im folgenden Codebeispiel wird die Nachlaufzeit des Sockets festgelegt und abgefragt.

' Sets the amount of time to linger after closing, using the LingerOption public property.
Dim lingerOption As New LingerOption(True, 10)
tcpClient.LingerState = lingerOption

' Gets the amount of linger time set, using the LingerOption public property.
If tcpClient.LingerState.LingerTime = 10 Then
   Console.WriteLine(("The linger state setting was successfully set to " + tcpClient.LingerState.LingerTime.ToString()))
End If

// sets the amount of time to linger after closing, using the LingerOption public property.
LingerOption lingerOption = new LingerOption (true, 10);

tcpClient.LingerState = lingerOption;

// gets the amount of linger time set, using the LingerOption public property.
if (tcpClient.LingerState.LingerTime == 10)
    Console.WriteLine ("The linger state setting was successfully set to " + tcpClient.LingerState.LingerTime.ToString ());

// sets the amount of time to linger after closing, using the LingerOption public property.
LingerOption^ lingerOption = gcnew LingerOption( true,10 );
tcpClient->LingerState = lingerOption;

// gets the amount of linger time set, using the LingerOption public property.
if ( tcpClient->LingerState->LingerTime == 10 )
      Console::WriteLine( "The linger state setting was successfully set to {0}", tcpClient->LingerState->LingerTime );

// sets the amount of time to linger after closing, using the
// LingerOption public property.
LingerOption lingerOption = new LingerOption(true, 10);
tcpClient.set_LingerState(lingerOption);

// gets the amount of linger time set, using the LingerOption public
// property.
if (tcpClient.get_LingerState().get_LingerTime() == 10) {
    Console.WriteLine("The linger state setting was successfully set to "
        + ((Int32)tcpClient.get_LingerState().get_LingerTime()).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
LingerOption-Klasse
Close
Write