ServicePointManager.MaxServicePoints Propriedade

Definição

Namespace:

System.Net

Assembly:

System.Net.ServicePoint.dll

Origem:

ServicePointManager.cs

Obtém ou define o número máximo de objetos ServicePoint a serem mantidos por vez.

public:
 static property int MaxServicePoints { int get(); void set(int value); };

public static int MaxServicePoints { get; set; }

static member MaxServicePoints : int with get, set

Public Shared Property MaxServicePoints As Integer

Valor da propriedade

Int32

O número máximo de objetos ServicePoint a serem mantidos. O valor padrão é 0, o que significa que não há nenhum limite para o número de objetos ServicePoint.

Exceções

ArgumentOutOfRangeException

MaxServicePoints é menor que 0 ou maior que Int32.MaxValue.

Exemplos

O exemplo de código a seguir define essa propriedade.

// Set the maximum number of ServicePoint instances to 
// maintain. If a ServicePoint instance for that host already 
// exists when your application requests a connection to
// an Internet resource, the ServicePointManager object
// returns this existing ServicePoint instance. If none exists 
// for that host, it creates a new ServicePoint instance.
ServicePointManager::MaxServicePoints = 4;

// Set the maximum idle time of a ServicePoint instance to 10 seconds.
// After the idle time expires, the ServicePoint object is eligible for
// garbage collection and cannot be used by the ServicePointManager.
ServicePointManager::MaxServicePointIdleTime = 10000;

// Set the maximum number of ServicePoint instances to
// maintain. If a ServicePoint instance for that host already
// exists when your application requests a connection to
// an Internet resource, the ServicePointManager object
// returns this existing ServicePoint instance. If none exists
// for that host, it creates a new ServicePoint instance.
ServicePointManager.MaxServicePoints = 4;

// Set the maximum idle time of a ServicePoint instance to 10 seconds.
// After the idle time expires, the ServicePoint object is eligible for
// garbage collection and cannot be used by the ServicePointManager object.
ServicePointManager.MaxServicePointIdleTime = 10000;

' Set the maximum number of ServicePoint instances to maintain.
' Note that, if a ServicePoint instance for that host already 
' exists when your application requests a connection to
' an Internet resource, the ServicePointManager object
' returns this existing ServicePoint. If none exists 
' for that host, it creates a new ServicePoint instance.
ServicePointManager.MaxServicePoints = 4

' Set the maximum idle time of a ServicePoint instance to 10 seconds.
' After the idle time expires, the ServicePoint object is eligible for
' garbage collection and cannot be used by the ServicePointManager.
ServicePointManager.MaxServicePointIdleTime = 10000

Comentários

Quando você reduz a MaxServicePoints propriedade abaixo do número de ServicePoint objetos existentes no momento, o ServicePointManager exclui os ServicePoint objetos com os tempos ociosos mais longos. Se o número de ServicePoint objetos com conexões ativas for maior que o valor de MaxServicePoints, o ServicePointManager objeto excluirá os objetos conforme eles ficam ociosos ServicePoint .

Confira também

• ServicePoint
• WebPermission