WebRequest.RegisterPrefix(String, IWebRequestCreate) Methode

Definition

Registriert ein WebRequest untergeordnetes Element für den angegebenen URI.

public:
 static bool RegisterPrefix(System::String ^ prefix, System::Net::IWebRequestCreate ^ creator);
public static bool RegisterPrefix (string prefix, System.Net.IWebRequestCreate creator);
static member RegisterPrefix : string * System.Net.IWebRequestCreate -> bool
Public Shared Function RegisterPrefix (prefix As String, creator As IWebRequestCreate) As Boolean

Parameter

prefix
String

Das vollständige URI- oder URI-Präfix, das die WebRequest untergeordneten Dienste darstellt.

creator
IWebRequestCreate

Die Create-Methode, die vom WebRequest aufgerufen wird, um das WebRequest untergeordnete Element zu erstellen.

Gibt zurück

true, wenn die Registrierung erfolgreich ist; andernfalls false.

Ausnahmen

prefix ist null

-oder-

creator ist null.

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

Die RegisterPrefix-Methode registriert WebRequest Nachfolger von Dienstanforderungen. WebRequest Untergeordneten werden in der Regel registriert, um ein bestimmtes Protokoll, z. B. HTTP oder FTP, zu verarbeiten, kann jedoch registriert werden, um eine Anforderung an einen bestimmten Server oder Pfad auf einem Server zu verarbeiten.

Die bereits registrierten Reservetypen umfassen Folgendes:

  • http://

  • https://

  • ftp://

  • file://

Weitere Informationen finden Sie unter den Methoden Create(String) und Create(Uri).

Doppelte Präfixe sind nicht zulässig. RegisterPrefix gibt false zurück, wenn versucht wird, ein doppeltes Präfix zu registrieren.

Anmerkung

Die klasse HttpWebRequest ist standardmäßig für Dienstanforderungen für HTTP- und HTTPS-Schemas registriert. Versuche, einen anderen WebRequest untergeordneten WebRequest für diese Schemas zu registrieren, schlagen fehl.

Gilt für: