Freigeben über


LingerOption-Klasse

Gibt an, ob und wie lange ein Socket nach dem Aufruf von Close die Verbindung aufrechterhält, wenn noch zu sendende Daten vorhanden sind.

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

Syntax

'Declaration
Public Class LingerOption
'Usage
Dim instance As LingerOption
public class LingerOption
public ref class LingerOption
public class LingerOption
public class LingerOption

Hinweise

Nachdem der Socket geschlossen wurde, sind möglicherweise noch Daten im ausgehenden Netzwerkpuffer vorhanden. Wenn Sie die Zeitspanne festlegen möchten, die der Socket versuchen soll, noch nicht gesendete Daten nach dem Schließen zu übertragen, erstellen Sie eine LingerOption, deren enable-Parameter auf true und deren seconds-Parameter auf die gewünschte Zeitspanne festgelegt wird. Der seconds-Parameter gibt an, wie lange der Socket die Verbindung aufrechterhalten soll, bevor das Timeout eintritt. Wenn der Socket die Verbindung nach dem Schließen nicht aufrechterhalten soll, erstellen Sie eine LingerOption, deren enable-Parameter auf true und deren seconds-Parameter auf 0 (null) festgelegt ist. Der Socket wird dann sofort geschlossen, und nicht gesendete Daten gehen verloren. Übergeben Sie nach der Erstellung die LingerOption an die Socket.SetSocketOption-Methode. Wenn Sie Daten mit einem TcpClient senden und empfangen, müssen Sie die LingerOption an die TcpClient.LingerState-Methode übergeben.

In der Standardeinstellung ist der Nachlauf mit einem Timeoutwert von 0 aktiviert. Der Socket versucht folglich, ausstehende Daten zu senden, bis keine Daten mehr im ausgehenden Netzwerkpuffer vorhanden sind.

Beispiel

Im folgenden Beispiel wird ein zuvor erstellter Socket auf eine Nachlaufzeit von einer Sekunde nach Aufruf der Close-Methode festgelegt.

Dim myOpts As New LingerOption(True, 1)
       
mySocket.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.Linger, _
   myOpts)
LingerOption myOpts = new LingerOption(true,1);

mySocket.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.Linger, myOpts);
LingerOption^ myOpts = gcnew LingerOption( true,1 );
mySocket->SetSocketOption( SocketOptionLevel::Socket, SocketOptionName::Linger, myOpts );
LingerOption myOpts = new LingerOption(true,1);
mySocket.SetSocketOption(SocketOptionLevel.Socket,
    SocketOptionName.Linger, myOpts);

Vererbungshierarchie

System.Object
  System.Net.Sockets.LingerOption

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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

LingerOption-Member
System.Net.Sockets-Namespace