ServicePoint.MaxIdleTime Property


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

Gets or sets the amount of time a connection associated with the ServicePoint object can remain idle before the connection is closed.

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

public int MaxIdleTime { get; set; }

Property Value

Type: System.Int32

The length of time, in milliseconds, that a connection associated with the ServicePoint object can remain idle before it is closed and reused for another connection.

Exception Condition

MaxIdleTime is set to less than Timeout.Infinite or greater than Int32.MaxValue.

You can set MaxIdleTime to Timeout.Infinite to indicate that a connection associated with the ServicePoint object should never time out.

The default value of the MaxIdleTime property is the value of the ServicePointManager.MaxServicePointIdleTime property when the ServicePoint object is created. Subsequent changes to the MaxServicePointIdleTime property have no effect on existing ServicePoint objects.

When the MaxIdleTime for a connection associated with a ServicePoint is exceeded, the connection remains open until the application tries to use the connection. At that time, the Framework closes the connection and creates a new connection to the remote host.

The following code example uses the MaxIdleTime property to set and retrieve the ServicePoint idle time.

// Display the date and time that the ServicePoint was last 
// connected to a host.
Console.WriteLine ("IdleSince = " + sp.IdleSince.ToString ());

// Display the maximum length of time that the ServicePoint instance  
// is allowed to maintain an idle connection to an Internet  
// resource before it is recycled for use in another connection.
Console.WriteLine ("MaxIdleTime = " + sp.MaxIdleTime);

.NET Framework
Available since 1.1
Return to top