ServicePointManager Klasse

Definition

Namespace:

System.Net

Assembly:

System.Net.ServicePoint.dll

Quelle:

ServicePointManager.cs

Verwaltet die Auflistung von ServicePoint-Objekten.

public ref class ServicePointManager

public class ServicePointManager

type ServicePointManager = class

Public Class ServicePointManager

Vererbung

Object

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 eine Verbindung mit einer Internetressource uniform Resource Identifier (URI) über das ServicePointManager-Objekt anfordert, gibt die ServicePointManager ein ServicePoint-Objekt zurück, das Verbindungsinformationen für den Host und das Schema enthält, das durch den URI identifiziert wird. Wenn für diesen Host und das Schema ein ServicePoint-Objekt 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 neues Sicherheitsfeature, das unsichere Verschlüsselungs- und Hashingalgorithmen für Verbindungen blockiert. Anwendungen, die TLS/SSL über APIs wie HttpClient, HttpWebRequest, FtpWebRequest, SmtpClient, SslStreamusw. verwenden und .NET Framework 4.6 als Ziel verwenden, 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.

Wichtig

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

Felder

DefaultNonPersistentConnectionLimit	Die Standardanzahl nicht persistenter Verbindungen (4), die für ein ServicePoint Objekt zulässig sind, das mit einem HTTP/1.0- oder höher-Server verbunden ist. Dieses Feld ist konstant, wird aber nicht mehr als .NET Framework 2.0 verwendet.
DefaultPersistentConnectionLimit	Die Standardanzahl der für ein ServicePoint Objekt zulässigen persistenten Verbindungen (2), 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

CheckCertificateRevocationList	Dient zum Abrufen oder Festlegen eines Boolean Werts, der angibt, ob das Zertifikat für die Sperrliste der Zertifizierungsstelle überprüft wird.
DefaultConnectionLimit	Ruft die maximale Anzahl gleichzeitiger Verbindungen ab, die von einem ServicePoint -Objekt zulässig sind, oder legt diese fest.
DnsRefreshTimeout	Dient zum Abrufen oder Festlegen eines Werts, der angibt, wie lange eine DNS-Auflösung (Domain Name Service) als gültig betrachtet wird.
EnableDnsRoundRobin	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	Ruft die EncryptionPolicy für diese ServicePointManager Instanz ab.
Expect100Continue	Dient zum Abrufen oder Festlegen eines Boolean Werts, der bestimmt, ob das Verhalten von 100-Continue verwendet wird.
MaxServicePointIdleTime	Dient zum Abrufen oder Festlegen der maximalen Leerlaufzeit eines ServicePoint -Objekts.
MaxServicePoints	Ruft die maximale Anzahl von ServicePoint Objekten ab, die jederzeit verwaltet werden sollen, oder legt diese fest.
ReusePort	Wenn Sie diesen Eigenschaftswert auf true festlegen, werden alle ausgehenden TCP-Verbindungen von HttpWebRequest verwendet, um die systemeigene Socketoption SO_REUSE_UNICASTPORT für den Socket zu verwenden. 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	Ruft ab oder legt das Sicherheitsprotokoll, das von den vom ServicePointManager -Objekt verwalteten ServicePoint -Objekten verwendet wird.
ServerCertificateValidationCallback	Ruft den Rückruf ab, um ein Serverzertifikat zu überprüfen, oder legt diesen fest.
UseNagleAlgorithm	Bestimmt, ob der Nagle-Algorithmus von den von diesem ServicePointManager -Objekt verwalteten Dienstpunkten verwendet wird.

Methoden

Equals(Object)	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, um die Kommunikation mit dem angegebenen URI (Uniform Resource Identifier) zu verwalten.
FindServicePoint(Uri, IWebProxy)	Veraltet. Sucht nach einem vorhandenen ServicePoint-Objekt oder erstellt ein neues ServicePoint-Objekt, um die Kommunikation mit dem angegebenen Uri-Objekt zu verwalten.
FindServicePoint(Uri)	Veraltet. Sucht nach einem vorhandenen ServicePoint-Objekt oder erstellt ein neues ServicePoint-Objekt, um die Kommunikation mit dem angegebenen Uri-Objekt zu verwalten.
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie der 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)

Weitere Informationen

• ServicePoint
• ServicePointManager-Element (Netzwerkeinstellungen)