WebRequest.RegisterPrefix(String, IWebRequestCreate) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> boolPublic Shared Function RegisterPrefix (prefix As String, creator As IWebRequestCreate) As BooleanParameter
- 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
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.
