WebRequest.RegisterPrefix(String, IWebRequestCreate) Methode

Referenz

Definition

Namespace:: System.Net

Assembly:: System.Net.Requests.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Quelle:: WebRequest.cs

Quelle:: WebRequest.cs

Quelle:: 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 Abhängige WebRequest für Dienstanforderungen. WebRequest Abhängige Werden in der Regel registriert, um ein bestimmtes Protokoll zu behandeln, z. B. HTTP oder FTP, können jedoch registriert werden, um eine Anforderung an einen bestimmten Server oder Pfad auf einem Server zu verarbeiten.

Zu den bereits registrierten vorregistrierten Reservetypen gehören:

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

Weitere Informationen finden Sie in 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 ist standardmäßig für Dienstanforderungen für HTTP- und HTTPS-Schemas registriert. Versuche, ein anderes WebRequest untergeordnetes Element für diese Schemas zu registrieren, schlagen fehl.

Gilt für: