Socket.LingerState Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Gets or sets a value that specifies whether the Socket will delay closing a socket in an attempt to send all pending data.

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

Public Property LingerState As LingerOption

Property Value

Type: System.Net.Sockets.LingerOption

A LingerOption that specifies how to linger while closing a socket.

Exception Condition

An error occurred when attempting to access the socket.


The Socket has been closed.

The LingerState property changes the way Close method behaves. This property when set modifies the conditions under which the connection can be reset by Winsock. Connection resets can still occur based on the IP protocol behavior.

This property controls the length of time that a connection-oriented connection will remain open after a call to Close when data remains to be sent.

When you call methods to send data to a peer, this data is placed in the outgoing network buffer. This property can be used to ensure that this data is sent to the remote host before the Close method drops the connection.

To enable lingering, create a LingerOption instance containing the desired values, and set the LingerState property to this instance.

The following table describes the behavior of the Close method for the possible values of the Enabled property and the LingerTime property stored in the LingerState property.




false (disabled), the default value

The time-out is not applicable, (default).

Attempts to send pending data until the default IP protocol time-out expires.

true (enabled)

A nonzero time-out

Attempts to send pending data until the specified time-out expires, and if the attempt fails, then Winsock resets the connection.

true (enabled)

A zero timeout.

Discards any pending data. For connection-oriented socket (TCP, for example), Winsock resets the connection.

The IP stack computes the default IP protocol time-out period to use based on the round trip time of the connection. In most cases, the time-out computed by the stack is more relevant than one defined by an application. This is the default behavior for a socket when the LingerState property is not set.

When the LingerTime property stored in the LingerState property is set greater than the default IP protocol time-out, the default IP protocol time-out will still apply and override.

The following code example demonstrates the use of the LingerState property.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 2.0
Return to top