ServicePointManager Klasse

Definition

Verwaltet die Auflistung von ServicePoint-Objekten.

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.

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 zum Erstellen, Verwalten und Löschen von Instanzen der ServicePoint -Klasse verwendet wird.

Wenn eine Anwendung über das ServicePointManager -Objekt eine Verbindung mit einer Internetressource(Uniform Resource Identifier, URI) anfordert, gibt das ein ServicePoint Objekt zurück, das ServicePointManager Verbindungsinformationen für den Host und das Schema enthält, die vom URI identifiziert werden. Wenn ein Objekt für diesen Host und dieses Schema vorhanden ServicePoint ist, gibt das ServicePointManager Objekt das vorhandene ServicePoint Objekt zurück, andernfalls erstellt das ServicePointManager Objekt ein neues ServicePoint Objekt.

Die .NET Framework 4.6 enthält ein neues Sicherheitsfeature, das unsichere Verschlüsselungs- und Hashingalgorithmen für Verbindungen blockiert. Anwendungen, die TLS/SSL über APIs wie HttpClient, , HttpWebRequest, SmtpClientFtpWebRequest, SslStream, usw. verwenden und für .NET Framework 4.6 abzielen, erhalten standardmäßig das sicherere Verhalten.

Entwickler möchten dieses Verhalten möglicherweise deaktivieren, um die Interoperabilität mit ihren vorhandenen SSL3-Diensten oder TLS w/ RC4-Diensten aufrechtzuerhalten. In diesem Artikel wird erläutert, wie Sie Ihren Code so ändern, dass das neue Verhalten deaktiviert wird.

Wichtig

Es wird nicht empfohlen, die ServicePointManager -Klasse für neue Entwicklungen zu verwenden. Verwenden Sie stattdessen die System.Net.Http.HttpClient -Klasse.

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. Dieses Feld ist konstant, wird aber ab .NET Framework 2.0 nicht mehr verwendet.

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. 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.

Eigenschaften

CertificatePolicy
Veraltet.

Ruft eine Richtlinie für Serverzertifikate ab oder legt diese fest.

CheckCertificateRevocationList

Ruft einen Boolean-Wert ab, der angibt, ob das Zertifikat anhand der Sperrliste der Zertifizierungsstelle überprüft wird, oder legt diesen fest.

DefaultConnectionLimit

Ruft die maximale Anzahl von gleichzeitigen Verbindungen ab, die für ein ServicePoint-Objekt zulässig sind, oder legt diese fest.

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.

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.

EncryptionPolicy

Ruft die EncryptionPolicy für diese ServicePointManager-Instanz ab.

Expect100Continue

Ruft einen Boolean-Wert ab, der bestimmt, ob 100-Continue-Verhalten verwendet wird, oder legt diesen fest.

MaxServicePointIdleTime

Ruft die maximale Leerlaufzeit eines ServicePoint-Objekts ab oder legt diese fest.

MaxServicePoints

Ruft die maximale Anzahl von ServicePoint-Objekten ab, die jederzeit verwaltet werden sollen, oder legt diese fest.

ReusePort

Durch Festlegen dieses Eigenschaftswerts auf true verwenden alle ausgehenden TCP-Verbindungen von HttpWebRequest die native Socketoption SO_REUSE_UNICASTPORT für den Socket. Dies bewirkt, dass die zugrunde liegenden ausgehenden Ports gemeinsam verwendet werden. 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.

SecurityProtocol

Ruft das Sicherheitsprotokoll ab, das von den vom ServicePointManager-Objekt verwalteten ServicePoint-Objekten verwendet wird, oder legt dieses fest.

ServerCertificateValidationCallback

Ruft den Rückruf zum Überprüfen eines Serverzertifikats ab oder legt diesen fest.

UseNagleAlgorithm

Bestimmt, ob der Nagle-Algorithmus von den Dienstpunkten verwendet wird, die von diesem ServicePointManager-Objekt verwaltet werden.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
FindServicePoint(String, IWebProxy)
Veraltet.

Sucht ein vorhandenes ServicePoint-Objekt oder erstellt ein neues ServicePoint-Objekt, um die Kommunikation mit dem angegebenen URI (Uniform Resource Identifier) zu verwalten.

FindServicePoint(Uri)
Veraltet.

Sucht ein vorhandenes ServicePoint-Objekt oder erstellt ein neues ServicePoint-Objekt, um die Kommunikation mit dem angegebenen Uri-Objekt zu verwalten.

FindServicePoint(Uri, IWebProxy)
Veraltet.

Sucht ein vorhandenes ServicePoint-Objekt oder erstellt ein neues ServicePoint-Objekt, um die Kommunikation mit dem angegebenen Uri-Objekt zu verwalten.

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

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

Aktiviert oder deaktiviert die Keep-Alive-Option für eine TCP-Verbindung.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Weitere Informationen