ServicePointManager Klasse

Definition

Achtung

WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead. Settings on ServicePointManager no longer affect SslStream or HttpClient.

Verwaltet die Auflistung von ServicePoint Objekten.

public ref class ServicePointManager
[System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead. Settings on ServicePointManager no longer affect SslStream or HttpClient.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public class ServicePointManager
public class ServicePointManager
[<System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead. Settings on ServicePointManager no longer affect SslStream or HttpClient.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
type ServicePointManager = class
type ServicePointManager = class
Public Class ServicePointManager
Vererbung
ServicePointManager
Attribute

Beispiele

Im folgenden Codebeispiel wird ein ServicePoint Objekt für Verbindungen mit dem URI www.contoso.comerstellt.

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 eine Verbindung mit einer Internetressource uniform Resource Identifier (URI) über das ServicePointManager Objekt anfordert, wird ein ServicePointManager Objekt zurückgegeben, ServicePoint das Verbindungsinformationen für den Vom URI identifizierten Host und Schema enthält. Wenn ein Objekt ServicePoint 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.

.NET Framework 4.6 enthält ein Sicherheitsfeature, das unsichere Verschlüsselungs- und Hashingalgorithmen für Verbindungen blockiert. Anwendungen, die TLS/SSL über APIs wie HttpClient, HttpWebRequest, FtpWebRequest, SmtpClient und SslStream verwenden und auf .NET Framework 4.6 oder höher ausgerichtet sind, 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 ist.

Important

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

Felder

Name Beschreibung
DefaultNonPersistentConnectionLimit
Veraltet.

Die Standardanzahl nicht persistenter Verbindungen (4) für ein ServicePoint Objekt, das mit einem HTTP/1.0- oder höher-Server verbunden ist. Dieses Feld ist konstant, wird jedoch nicht mehr als .NET Framework 2.0 verwendet.

DefaultPersistentConnectionLimit
Veraltet.

Die Standardanzahl persistenter Verbindungen (2) für ein ServicePoint Objekt, das mit einem HTTP/1.1- oder höher-Server verbunden ist. Dieses Feld ist konstant und wird verwendet, um die DefaultConnectionLimit Eigenschaft zu initialisieren, wenn der Wert der DefaultConnectionLimit Eigenschaft nicht direkt oder über die Konfiguration festgelegt wurde.

Eigenschaften

Name Beschreibung
CertificatePolicy
Veraltet.

Dient zum Abrufen oder Festlegen der Richtlinie für Serverzertifikate.

CheckCertificateRevocationList
Veraltet.

Dient zum Abrufen oder Festlegen eines Boolean Werts, der angibt, ob das Zertifikat für die Sperrliste der Zertifizierungsstelle überprüft wird.

DefaultConnectionLimit
Veraltet.

Ruft die maximale Anzahl gleichzeitiger Verbindungen ab, die von einem ServicePoint Objekt zulässig sind, oder legt diese fest.

DnsRefreshTimeout
Veraltet.

Dient zum Abrufen oder Festlegen eines Werts, der angibt, wie lange eine DNS-Auflösung (Domain Name Service) als gültig betrachtet wird.

EnableDnsRoundRobin
Veraltet.

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob eine DNS-Auflösung (Domain Name Service) zwischen den entsprechenden Ip-Protokolladressen gedreht wird.

EncryptionPolicy
Veraltet.

Ruft die EncryptionPolicy für diese ServicePointManager Instanz ab.

Expect100Continue
Veraltet.

Dient zum Abrufen oder Festlegen eines Boolean Werts, der bestimmt, ob das Verhalten von 100-Continue verwendet wird.

MaxServicePointIdleTime
Veraltet.

Dient zum Abrufen oder Festlegen der maximalen Leerlaufzeit eines ServicePoint Objekts.

MaxServicePoints
Veraltet.

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

ReusePort
Veraltet.

Durch Festlegen dieses Eigenschaftswerts true werden alle ausgehenden TCP-Verbindungen von HttpWebRequest die systemeigene Socketoption SO_REUSE_UNICASTPORT für den Socket verwendet. Dies bewirkt, dass die zugrunde liegenden ausgehenden Ports freigegeben werden. Dies ist nützlich für Szenarien, in denen eine große Anzahl ausgehender Verbindungen in kurzer Zeit hergestellt wird, und die App riskiert, dass keine Ports mehr vorhanden sind.

SecurityProtocol
Veraltet.

Dient zum Abrufen oder Festlegen des Sicherheitsprotokolls, das von den objekten verwendet wird, die ServicePointServicePointManager vom Objekt verwaltet werden.

ServerCertificateValidationCallback
Veraltet.

Ruft den Rückruf ab, um ein Serverzertifikat zu überprüfen, oder legt diesen fest.

UseNagleAlgorithm
Veraltet.

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

Methoden

Name Beschreibung
Equals(Object)
Veraltet.

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

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

Sucht ein vorhandenes ServicePoint Objekt oder erstellt ein neues ServicePoint Objekt zum Verwalten der Kommunikation mit dem angegebenen URI (Uniform Resource Identifier).

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.

FindServicePoint(Uri)
Veraltet.

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

GetHashCode()
Veraltet.

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()
Veraltet.

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()
Veraltet.

Erstellt eine flache Kopie der aktuellen Object.

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

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

ToString()
Veraltet.

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

(Geerbt von Object)

Gilt für:

Weitere Informationen