WebRequest.RegisterPrefix(String, IWebRequestCreate) Methode

Referenz

Definition

Namespace:: System.Net

Assembly:: System.Net.Requests.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Source:: WebRequest.cs

Source:: WebRequest.cs

Source:: WebRequest.cs

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 einen WebRequest-Nachfolger 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

Der vollständige URI oder das URI-Präfix, der bzw. das derWebRequest -Nachfolger bearbeitet.

creator: IWebRequestCreate

Die Erstellungsmethode, die die WebRequest zum Erstellen des WebRequest-Nachfolgers aufruft.

Gibt zurück

Boolean

true, wenn die Registrierung erfolgreich ist, andernfalls false.

Ausnahmen

ArgumentNullException

prefix ist gleich null.

- oder -

creator ist null.

Hinweise

Die RegisterPrefix -Methode registriert WebRequest Nachfolger für Dienstanforderungen. WebRequest Nachfolger werden in der Regel für die Verarbeitung eines bestimmten Protokolls wie HTTP oder FTP registriert, können jedoch registriert werden, um eine Anforderung an einen bestimmten Server oder Pfad auf einem Server zu verarbeiten.

Die bereits registrierten vorab registrierten Reservetypen umfassen Folgendes:

http://
https://
ftp://
file://

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

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

Hinweis

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

Gilt für: