Export (0) Print
Expand All

ServicePoint.MaxIdleTime Property

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:
property int MaxIdleTime {
	int get ();
	void set (int value);
}
/** @property */
public int get_MaxIdleTime ()

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

public function get MaxIdleTime () : int

public function set MaxIdleTime (value : int)

Not applicable.

Property Value

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 typeCondition

ArgumentOutOfRangeException

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 = {0}", sp->IdleSince );

// 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 = {0}", sp->MaxIdleTime );


// Display the date and time that the ServicePoint was last 
// connected to a host.
Console.WriteLine(("IdleSince = " + sp.get_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.get_MaxIdleTime()));

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft