WebRequest.RegisterPrefix(String, IWebRequestCreate) Method

Definition

Registriert einen WebRequest-Nachfolger für den angegebenen URI.Registers a WebRequest descendant for the specified 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

Parameters

prefix
String

Der vollständige URI oder das URI-Präfix, der bzw. das derWebRequest -Nachfolger bearbeitet.The complete URI or URI prefix that the WebRequest descendant services.

creator
IWebRequestCreate

Die Erstellungsmethode, die die WebRequest zum Erstellen des WebRequest-Nachfolgers aufruft.The create method that the WebRequest calls to create the WebRequest descendant.

Returns

Boolean

true, wenn die Registrierung erfolgreich ist, andernfalls false.true if registration is successful; otherwise, false.

Exceptions

prefix ist null.prefix is null

Oder-or- creator ist nullcreator is null.

Remarks

Die RegisterPrefix-Methode registriert WebRequest Nachfolger für Service Requests.The RegisterPrefix method registers WebRequest descendants to service requests. WebRequest Nachfolger werden in der Regel für die Verarbeitung eines bestimmten Protokolls (z. b. http oder FTP) registriert, können jedoch registriert werden, um eine Anforderung an einen bestimmten Server oder Pfad auf einem Server zu verarbeiten.WebRequest descendants are typically registered to handle a specific protocol, such HTTP or FTP, but can be registered to handle a request to a specific server or path on a server.

Die bereits registrierten Reserve Typen umfassen Folgendes:The pre-registered reserve types already registered include the following:

  • http://

  • https://

  • ftp://

  • file://

Weitere Informationen finden Sie unter den Methoden Create(String) und Create(Uri).For more information, see the Create(String) and Create(Uri) methods.

Doppelte Präfixe sind nicht zulässig.Duplicate prefixes are not allowed. RegisterPrefix gibt false zurück, wenn versucht wird, ein doppeltes Präfix zu registrieren.RegisterPrefix returns false if an attempt is made to register a duplicate prefix.

Note

Die HttpWebRequest-Klasse ist standardmäßig für Dienst Anforderungen für http-und HTTPS-Schemas registriert.The HttpWebRequest class is registered to service requests for HTTP and HTTPS schemes by default. Der Versuch, einen anderen WebRequest Nachfolger für diese Schemas zu registrieren, schlägt fehl.Attempts to register a different WebRequest descendant for these schemes will fail.

Applies to