ServicePointManager Klasse

Definition

Verwaltet die Auflistung von ServicePoint-Objekten.Manages the collection of ServicePoint objects.

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

Beispiele

Im folgenden Codebeispiel wird ein ServicePoint-Objekt für Verbindungen mit dem URI-www.contoso.comerstellt.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)

Hinweise

ServicePointManager ist eine statische Klasse, die verwendet wird, um Instanzen der ServicePoint-Klasse zu erstellen, zu verwalten und zu löschen.ServicePointManager is a static class used to create, maintain, and delete instances of the ServicePoint class.

Wenn eine Anwendung über das ServicePointManager-Objekt eine Verbindung mit einem Internet Ressourcen Uniform Resource Identifier (URI) anfordert, gibt die ServicePointManager ein ServicePoint Objekt zurück, das Verbindungsinformationen für den Host und das Schema enthält, die durch den URI identifiziert werden.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. Wenn ein vorhandenes ServicePoint Objekt für diesen Host und dieses Schema vorhanden ist, gibt das ServicePointManager Objekt das vorhandene ServicePoint Objekt zurück. Andernfalls erstellt das ServicePointManager-Objekt ein neues ServicePoint-Objekt.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.

Der .NET Framework 4,6 umfasst ein neues Sicherheits Feature, das unsichere Verschlüsselungs-und Hash Algorithmen für Verbindungen blockiert.The .NET Framework 4.6 includes a new security feature that blocks insecure cipher and hashing algorithms for connections. Anwendungen, die TLS/SSL über APIs verwenden, wie z. b. HttpClient, HttpWebRequest, FtpWebRequest, SmtpClient, SslStreamusw. und Ziel .NET Framework 4,6, erhalten standardmäßig das sicherere Verhalten.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.

Entwickler möchten dieses Verhalten möglicherweise ablehnen, um die Interoperabilität mit Ihren vorhandenen SSL3 Services-oder TLS-/RC4-Diensten aufrechtzuerhalten.Developers may want to opt out of this behavior in order to maintain interoperability with their existing SSL3 services or TLS w/ RC4 services. In diesem Artikel wird erläutert, wie Sie den Code so ändern, dass das neue Verhalten deaktiviert ist.This article explains how to modify your code so that the new behavior is disabled.

Felder

DefaultNonPersistentConnectionLimit

Die Standardanzahl von nicht permanenten Verbindungen (4), die für ein ServicePoint-Objekt zulässig sind, das mit einem Server mit HTTP/1.0 oder höher verbunden ist.The default number of non-persistent connections (4) allowed on a ServicePoint object connected to an HTTP/1.0 or later server. Dieses Feld ist konstant, wird aber in .NET Framework 2.0 nicht mehr verwendet.This field is constant but is no longer used in the .NET Framework 2.0.

DefaultPersistentConnectionLimit

Die Standardanzahl von permanenten Verbindungen (2), die für ein ServicePoint-Objekt zulässig sind, das mit einem Server mit HTTP/1.1 oder höher verbunden ist.The default number of persistent connections (2) allowed on a ServicePoint object connected to an HTTP/1.1 or later server. Dieses Feld ist konstant und wird zum Initialisieren der DefaultConnectionLimit-Eigenschaft verwendet, wenn der Wert der DefaultConnectionLimit-Eigenschaft weder direkt noch über die Konfiguration festgelegt wurde.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.

Eigenschaften

CertificatePolicy

Ruft eine Richtlinie für Serverzertifikate ab oder legt diese fest.Gets or sets policy for server certificates.

CheckCertificateRevocationList

Ruft einen Boolean-Wert ab, der angibt, ob das Zertifikat anhand der Sperrliste der Zertifizierungsstelle überprüft wird, oder legt diesen fest.Gets or sets a Boolean value that indicates whether the certificate is checked against the certificate authority revocation list.

ClientCipherSuitesCallback
DefaultConnectionLimit

Ruft die maximale Anzahl von gleichzeitigen Verbindungen ab, die für ein ServicePoint-Objekt zulässig sind, oder legt diese fest.Gets or sets the maximum number of concurrent connections allowed by a ServicePoint object.

DnsRefreshTimeout

Ruft einen Wert ab, der die Zeitspanne angibt, für die eine DNS (Domain Name Service)-Auflösung als gültig angesehen wird, oder legt diesen fest.Gets or sets a value that indicates how long a Domain Name Service (DNS) resolution is considered valid.

EnableDnsRoundRobin

Ruft einen Wert ab, der angibt, ob die DNS (Domain Name Service)-Auflösung abwechselnd die anwendbaren IP (Internet Protocol)-Adressen verwendet, oder legt diesen fest.Gets or sets a value that indicates whether a Domain Name Service (DNS) resolution rotates among the applicable Internet Protocol (IP) addresses.

EncryptionPolicy

Ruft die EncryptionPolicy für diese ServicePointManager-Instanz ab.Gets the EncryptionPolicy for this ServicePointManager instance.

Expect100Continue

Ruft einen Boolean-Wert ab, der bestimmt, ob 100-Continue-Verhalten verwendet wird, oder legt diesen fest.Gets or sets a Boolean value that determines whether 100-Continue behavior is used.

MaxServicePointIdleTime

Ruft die maximale Leerlaufzeit eines ServicePoint-Objekts ab oder legt diese fest.Gets or sets the maximum idle time of a ServicePoint object.

MaxServicePoints

Ruft die maximale Anzahl von ServicePoint-Objekten ab, die jederzeit verwaltet werden sollen, oder legt diese fest.Gets or sets the maximum number of ServicePoint objects to maintain at any time.

ReusePort

Durch Festlegen dieses Eigenschaftswerts auf true verwenden alle ausgehenden TCP-Verbindungen von HttpWebRequest die native Socketoption SO_REUSE_UNICASTPORT für den 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. Dies bewirkt, dass die zugrunde liegenden ausgehenden Ports gemeinsam verwendet werden.This causes the underlying outgoing ports to be shared. Dies ist hilfreich in Szenarios, in denen eine große Anzahl von ausgehenden Verbindungen in kurzer Zeit hergestellt wird und die App über nicht genügend Ports verfügt.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

Ruft das Sicherheitsprotokoll ab, das von den vom ServicePointManager-Objekt verwalteten ServicePoint-Objekten verwendet wird, oder legt dieses fest.Gets or sets the security protocol used by the ServicePoint objects managed by the ServicePointManager object.

ServerCertificateValidationCallback

Ruft den Rückruf zum Überprüfen eines Serverzertifikats ab oder legt diesen fest.Gets or sets the callback to validate a server certificate.

ServerCipherSuitesCallback
UseNagleAlgorithm

Bestimmt, ob der Nagle-Algorithmus von den Dienstpunkten verwendet wird, die von diesem ServicePointManager-Objekt verwaltet werden.Determines whether the Nagle algorithm is used by the service points managed by this ServicePointManager object.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
FindServicePoint(String, IWebProxy)

Sucht ein vorhandenes ServicePoint-Objekt oder erstellt ein neues ServicePoint-Objekt, um die Kommunikation mit dem angegebenen URI (Uniform Resource Identifier) zu verwalten.Finds an existing ServicePoint object or creates a new ServicePoint object to manage communications with the specified Uniform Resource Identifier (URI).

FindServicePoint(Uri)

Sucht ein vorhandenes ServicePoint-Objekt oder erstellt ein neues ServicePoint-Objekt, um die Kommunikation mit dem angegebenen Uri-Objekt zu verwalten.Finds an existing ServicePoint object or creates a new ServicePoint object to manage communications with the specified Uri object.

FindServicePoint(Uri, IWebProxy)

Sucht ein vorhandenes ServicePoint-Objekt oder erstellt ein neues ServicePoint-Objekt, um die Kommunikation mit dem angegebenen Uri-Objekt zu verwalten.Finds an existing ServicePoint object or creates a new ServicePoint object to manage communications with the specified Uri object.

GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
SetTcpKeepAlive(Boolean, Int32, Int32)

Aktiviert oder deaktiviert die Keep-Alive-Option für eine TCP-Verbindung.Enables or disables the keep-alive option on a TCP connection.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für:

Siehe auch