WebRequest.RegisterPrefix(String, IWebRequestCreate) Methode

Definition

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

prefix ist gleich null.

- oder - creator ist null.

Hinweise

Die RegisterPrefix Methode registriert WebRequest untergeordnete Elemente für Dienstanforderungen. WebRequest Die Untergeordneten werden in der Regel registriert, um ein bestimmtes Protokoll, z. B. HTTP oder FTP, zu behandeln, kann jedoch registriert werden, um eine Anforderung an einen bestimmten Server oder Pfad auf einem Server zu behandeln.

Die bereits registrierten Reservetypen umfassen folgendes:

  • http://

  • https://

  • ftp://

  • file://

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

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

Hinweis

Die HttpWebRequest Klasse wird standardmäßig für Dienstanforderungen für HTTP- und HTTPS-Schemas registriert. Versuche, eine andere WebRequest Absteigende für diese Schemas zu registrieren, schlägt fehl.

Gilt für: