ServicePointManager Clase

Definición

Administra la colección de objetos ServicePoint.Manages the collection of ServicePoint objects.

public ref class ServicePointManager
public class ServicePointManager
type ServicePointManager = class
Public Class ServicePointManager
Herencia
ServicePointManager

Ejemplos

En el ejemplo de código siguiente ServicePoint se crea un objeto para las conexiones al 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)

Comentarios

ServicePointManager es una clase estática que se usa para crear, mantener y eliminar instancias de la ServicePoint clase.ServicePointManager is a static class used to create, maintain, and delete instances of the ServicePoint class.

Cuando una aplicación solicita una conexión a un identificador uniforme de recursos (URI) de recursos de Internet a través del ServicePointManager objeto, ServicePointManager devuelve un ServicePoint objeto que contiene información de conexión para el host y el esquema identificados por el 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. Si hay un objeto existente ServicePoint para ese host y esquema, el ServicePointManager objeto devuelve el objeto existente ServicePoint ; de lo contrario, el ServicePointManager objeto crea un nuevo ServicePoint objeto.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.

El .NET Framework 4,6 incluye una nueva característica de seguridad que bloquea los algoritmos hash y de cifrado no seguros para las conexiones.The .NET Framework 4.6 includes a new security feature that blocks insecure cipher and hashing algorithms for connections. Las aplicaciones que usan TLS/SSL a través de API como HttpClient , HttpWebRequest , FtpWebRequest ,, SmtpClient SslStream , etc. y que tienen como destino .NET Framework 4,6 obtienen el comportamiento más seguro de forma predeterminada.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.

Los desarrolladores pueden querer dejar de participar en este comportamiento con el fin de mantener la interoperabilidad con sus servicios de SSL3 Services o TLS w/RC4 existentes.Developers may want to opt out of this behavior in order to maintain interoperability with their existing SSL3 services or TLS w/ RC4 services. En este artículo se explica cómo modificar el código para que el nuevo comportamiento se deshabilite.This article explains how to modify your code so that the new behavior is disabled.

Importante

No se recomienda usar la ServicePointManager clase para el nuevo desarrollo.We don't recommend that you use the ServicePointManager class for new development. En su lugar, use la System.Net.Http.HttpClient clase.Instead, use the System.Net.Http.HttpClient class.

Campos

DefaultNonPersistentConnectionLimit

El número predeterminado de conexiones no persistentes (4) que se permite en un objeto ServicePoint conectado a un servidor HTTP/1.0 o posterior.The default number of non-persistent connections (4) allowed on a ServicePoint object connected to an HTTP/1.0 or later server. Este campo es constante pero ya no se usa a partir de .NET Framework 2.0.This field is constant but is no longer used as of .NET Framework 2.0.

DefaultPersistentConnectionLimit

El número predeterminado de conexiones persistentes (2) que se permite en un objeto ServicePoint conectado a un servidor HTTP/1.1 o posterior.The default number of persistent connections (2) allowed on a ServicePoint object connected to an HTTP/1.1 or later server. Este campo es constante y se usa para inicializar la propiedad DefaultConnectionLimit si el valor de la propiedad DefaultConnectionLimit no se estableció ni directamente ni a través de la configuración.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.

Propiedades

CertificatePolicy
Obsoleto.
Obsoleto.

Obtiene o establece la directiva de certificados de servidor.Gets or sets policy for server certificates.

CheckCertificateRevocationList

Obtiene o establece un valor Boolean que indica si el certificado se coteja con la lista de revocación de la entidad de certificación.Gets or sets a Boolean value that indicates whether the certificate is checked against the certificate authority revocation list.

ClientCipherSuitesCallback
DefaultConnectionLimit

Obtiene o establece el número máximo de conexiones simultáneas permitido por un objeto ServicePoint.Gets or sets the maximum number of concurrent connections allowed by a ServicePoint object.

DnsRefreshTimeout

Obtiene o establece un valor que indica cuánto tiempo se considera válida una resolución del Servicio de nombres de dominio (DNS).Gets or sets a value that indicates how long a Domain Name Service (DNS) resolution is considered valid.

EnableDnsRoundRobin

Obtiene o establece un valor que indica si una resolución del Servicio de nombres de dominio (DNS) rota entre las direcciones del protocolo Internet (IP) aplicables.Gets or sets a value that indicates whether a Domain Name Service (DNS) resolution rotates among the applicable Internet Protocol (IP) addresses.

EncryptionPolicy

Obtiene el objeto EncryptionPolicy para esta instancia de ServicePointManager.Gets the EncryptionPolicy for this ServicePointManager instance.

Expect100Continue

Obtiene o establece un valor Boolean que determina si se usa el comportamiento 100-Continue.Gets or sets a Boolean value that determines whether 100-Continue behavior is used.

MaxServicePointIdleTime

Obtiene o establece el tiempo de inactividad máximo de un objeto ServicePoint.Gets or sets the maximum idle time of a ServicePoint object.

MaxServicePoints

Obtiene o establece el número máximo de objetos ServicePoint que deben mantenerse en cualquier momento.Gets or sets the maximum number of ServicePoint objects to maintain at any time.

ReusePort

Al establecer este valor de propiedad en true, todas las conexiones TCP salientes de HttpWebRequest usan la opción de socket nativo SO_REUSE_UNICASTPORT en el socket.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. Esto provoca que se compartan los puertos salientes subyacentes.This causes the underlying outgoing ports to be shared. Es útil en los escenarios en los que se efectúa un gran número de conexiones salientes en poco tiempo, y la aplicación se arriesga a quedarse sin puertos.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

Obtiene o establece el protocolo de seguridad usado por los objetos ServicePoint administrados por el objeto ServicePointManager.Gets or sets the security protocol used by the ServicePoint objects managed by the ServicePointManager object.

ServerCertificateValidationCallback

Obtiene o establece la devolución de llamada para validar un certificado de servidor.Gets or sets the callback to validate a server certificate.

ServerCipherSuitesCallback
UseNagleAlgorithm

Determina si los puntos del servicio administrados por este objeto ServicePointManager utilizan el algoritmo de Nagle.Determines whether the Nagle algorithm is used by the service points managed by this ServicePointManager object.

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
FindServicePoint(String, IWebProxy)

Busca un objeto ServicePoint existente o crea un objeto ServicePoint nuevo para administrar las comunicaciones con el identificador URI especificado.Finds an existing ServicePoint object or creates a new ServicePoint object to manage communications with the specified Uniform Resource Identifier (URI).

FindServicePoint(Uri)

Busca un objeto ServicePoint existente o crea un objeto ServicePoint nuevo para administrar las comunicaciones con el objeto Uri especificado.Finds an existing ServicePoint object or creates a new ServicePoint object to manage communications with the specified Uri object.

FindServicePoint(Uri, IWebProxy)

Busca un objeto ServicePoint existente o crea un objeto ServicePoint nuevo para administrar las comunicaciones con el objeto Uri especificado.Finds an existing ServicePoint object or creates a new ServicePoint object to manage communications with the specified Uri object.

GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
SetTcpKeepAlive(Boolean, Int32, Int32)

Habilita o deshabilita la opción keep-alive en una conexión TCP.Enables or disables the keep-alive option on a TCP connection.

ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Se aplica a

Consulte también