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 aufweisen.
- creator
- IWebRequestCreate
Die Create-Methode, die von den WebRequest Aufrufen zum Erstellen des WebRequest untergeordneten Objekt aufgerufen wird.
Gibt zurück
truewenn 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 für Dienstanforderungen. WebRequest Nachfolger 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 und Create(String) den Create(Uri) Methoden.
Doppelte Präfixe sind nicht zulässig.
RegisterPrefix gibt zurück false , wenn versucht wird, ein doppeltes Präfix zu registrieren.
Note
Die HttpWebRequest Klasse ist standardmäßig für Dienstanforderungen für HTTP- und HTTPS-Schemas registriert. Versuche, für diese Schemas einen anderen WebRequest Nachfolger zu registrieren, schlagen fehl.