ServicePointManager Класс

Определение

Управляет коллекцией объектов ServicePoint.Manages the collection of ServicePoint objects.

public ref class ServicePointManager
public class ServicePointManager
type ServicePointManager = class
Public Class ServicePointManager
Наследование
ServicePointManager

Примеры

В следующем примере кода создается объект ServicePoint для соединений с URI www.contoso.com.The following code example creates a ServicePoint object for connections to the URI www.contoso.com.

Uri^ myUri = gcnew Uri( "http://www.contoso.com/" );
ServicePoint^ mySP = ServicePointManager::FindServicePoint( myUri );
Uri myUri = new Uri("http://www.contoso.com/");
 
ServicePoint mySP = ServicePointManager.FindServicePoint(myUri);
Dim myUri As New Uri("http://www.contoso.com/")
       
Dim mySP As ServicePoint = ServicePointManager.FindServicePoint(myUri)

Комментарии

ServicePointManager является статическим классом, используемым для создания, сопровождения и удаления экземпляров класса ServicePoint.ServicePointManager is a static class used to create, maintain, and delete instances of the ServicePoint class.

Когда приложение запрашивает подключение к универсальному идентификатору ресурса (URI) Интернет-ресурса через объект ServicePointManager, ServicePointManager возвращает объект ServicePoint, который содержит сведения о соединении для узла и схемы, идентифицируемые по универсальному коду ресурса (URI).When an application requests a connection to an Internet resource Uniform Resource Identifier (URI) through the ServicePointManager object, the ServicePointManager returns a ServicePoint object that contains connection information for the host and scheme identified by the URI. Если для этого узла и схемы имеется существующий объект ServicePoint, объект ServicePointManager возвращает существующий объект ServicePoint. в противном случае объект ServicePointManager создает новый объект ServicePoint.If there is an existing ServicePoint object for that host and scheme, the ServicePointManager object returns the existing ServicePoint object; otherwise, the ServicePointManager object creates a new ServicePoint object.

.NET Framework 4,6 включает новую функцию безопасности, которая блокирует небезопасные алгоритмы шифрования и хеширования для подключений.The .NET Framework 4.6 includes a new security feature that blocks insecure cipher and hashing algorithms for connections. Приложения, использующие TLS/SSL через API-интерфейсы, такие как HttpClient, HttpWebRequest, FtpWebRequest, SmtpClient, SslStreamи т. д. и нацеливание .NET Framework 4,6, по умолчанию получают более безопасное поведение.Applications using TLS/SSL through APIs such as HttpClient, HttpWebRequest, FtpWebRequest, SmtpClient, SslStream, etc. and targeting .NET Framework 4.6 get the more-secure behavior by default.

Разработчики могут захотеть отказаться от этого поведения, чтобы обеспечить взаимодействие с имеющимися службами SSL3 Services или TLS w/RC4.Developers may want to opt out of this behavior in order to maintain interoperability with their existing SSL3 services or TLS w/ RC4 services. В этой статье объясняется, как изменить код таким образом, чтобы новое поведение было отключено.This article explains how to modify your code so that the new behavior is disabled.

Поля

DefaultNonPersistentConnectionLimit

Допустимое по умолчанию количество непостоянных подключений (4) в объекте ServicePoint, подключенном к серверу HTTP/1.0 или к более старшей версии сервера.The default number of non-persistent connections (4) allowed on a ServicePoint object connected to an HTTP/1.0 or later server. Это поле является константой, но больше не используется на платформе .NET Framework 2.0.This field is constant but is no longer used in the .NET Framework 2.0.

DefaultPersistentConnectionLimit

Допустимое по умолчанию количество постоянных подключений (2) в объекте ServicePoint, подключенном к серверу HTTP/1.1 или к более старшей версии сервера.The default number of persistent connections (2) allowed on a ServicePoint object connected to an HTTP/1.1 or later server. Это поле является константой и используется для инициализации свойства DefaultConnectionLimit, если значение свойства DefaultConnectionLimit не было задано напрямую или посредством конфигурации.This field is constant and is used to initialize the DefaultConnectionLimit property if the value of the DefaultConnectionLimit property has not been set either directly or through configuration.

Свойства

CertificatePolicy

Возвращает или устанавливает политику для сертификатов сервера.Gets or sets policy for server certificates.

CheckCertificateRevocationList

Возвращает или задает значение Boolean, указывающее, проверяется ли сертификат по списку отзыва сертификатов.Gets or sets a Boolean value that indicates whether the certificate is checked against the certificate authority revocation list.

ClientCipherSuitesCallback
DefaultConnectionLimit

Возвращает или задает максимальное число одновременных подключений, разрешенное объектом ServicePoint.Gets or sets the maximum number of concurrent connections allowed by a ServicePoint object.

DnsRefreshTimeout

Возвращает или задает значение, указывающее промежуток времени, в течение которого разрешение DNS-имени считается допустимым.Gets or sets a value that indicates how long a Domain Name Service (DNS) resolution is considered valid.

EnableDnsRoundRobin

Возвращает или задает значение, которое указывает, происходит ли чередование допустимых IP-адресов при разрешении DNS-имен.Gets or sets a value that indicates whether a Domain Name Service (DNS) resolution rotates among the applicable Internet Protocol (IP) addresses.

EncryptionPolicy

Получает объект EncryptionPolicy для этого экземпляра ServicePointManager.Gets the EncryptionPolicy for this ServicePointManager instance.

Expect100Continue

Возвращает или задает значение Boolean, которое определяет, используется ли поведение 100-Continue.Gets or sets a Boolean value that determines whether 100-Continue behavior is used.

MaxServicePointIdleTime

Возвращает или задает максимальное время бездействия объекта ServicePoint.Gets or sets the maximum idle time of a ServicePoint object.

MaxServicePoints

Возвращает или задает максимальное количество объектов ServicePoint, обслуживаемых в произвольный момент времени.Gets or sets the maximum number of ServicePoint objects to maintain at any time.

ReusePort

Значение свойства true заставляет все исходящие соединения TCP из HttpWebRequest использовать собственный параметр сокета SO_REUSE_UNICASTPORT.Setting this property value to true causes all outbound TCP connections from HttpWebRequest to use the native socket option SO_REUSE_UNICASTPORT on the socket. Это приводит к совместному использованию базовых исходящих портов.This causes the underlying outgoing ports to be shared. Это удобно в сценариях, где за короткое время выполняется большое количество исходящих подключений, и приложение рискует запуститься без портов.This is useful for scenarios where a large number of outgoing connections are made in a short time, and the app risks running out of ports.

SecurityProtocol

Возвращает или задает протокол безопасности, используемый объектами ServicePoint, которые управляются объектом ServicePointManager.Gets or sets the security protocol used by the ServicePoint objects managed by the ServicePointManager object.

ServerCertificateValidationCallback

Возвращает или задает обратный вызов для проверки сертификата сервера.Gets or sets the callback to validate a server certificate.

ServerCipherSuitesCallback
UseNagleAlgorithm

Определяет, используется ли алгоритм Nagle точками обслуживания, которыми управляет объект ServicePointManager.Determines whether the Nagle algorithm is used by the service points managed by this ServicePointManager object.

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
FindServicePoint(String, IWebProxy)

Находит существующий объект ServicePoint или создает новый объект ServicePoint для управления связью с ресурсом, имеющим заданный URI.Finds an existing ServicePoint object or creates a new ServicePoint object to manage communications with the specified Uniform Resource Identifier (URI).

FindServicePoint(Uri)

Находит существующий объект ServicePoint или создает новый объект ServicePoint для управления связью с заданным объектом Uri.Finds an existing ServicePoint object or creates a new ServicePoint object to manage communications with the specified Uri object.

FindServicePoint(Uri, IWebProxy)

Находит существующий объект ServicePoint или создает новый объект ServicePoint для управления связью с заданным объектом Uri.Finds an existing ServicePoint object or creates a new ServicePoint object to manage communications with the specified Uri object.

GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
SetTcpKeepAlive(Boolean, Int32, Int32)

Включает или отключает параметр поддержания активности соединения TCP.Enables or disables the keep-alive option on a TCP connection.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Применяется к

Дополнительно