WebRequest.RegisterPrefix(String, IWebRequestCreate) Metod

Definition

Registrerar en WebRequest underordnad för den angivna URI:n.

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

Parametrar

prefix
String

Det fullständiga URI- eller URI-prefixet som underordnade WebRequest tjänster.

creator
IWebRequestCreate

Den create-metod som anropas WebRequest för att skapa den WebRequest underordnade.

Returer

trueom registreringen lyckas. annars . false

Undantag

prefix är null

-eller-

creator är null.

Kommentarer

Caution

WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.

Metoden RegisterPrefix registrerar WebRequest underordnade till tjänstbegäranden. WebRequest underordnade är vanligtvis registrerade för att hantera ett specifikt protokoll, till exempel HTTP eller FTP, men kan registreras för att hantera en begäran till en specifik server eller sökväg på en server.

De förregistrerade reservtyperna som redan har registrerats innehåller följande:

  • http://

  • https://

  • ftp://

  • file://

Mer information finns i Create(String) metoderna och Create(Uri) .

Duplicerade prefix tillåts inte. RegisterPrefix returnerar false om ett försök görs att registrera ett duplicerat prefix.

Note

Klassen HttpWebRequest är registrerad på tjänstbegäranden för HTTP- och HTTPS-scheman som standard. Försök att registrera en annan WebRequest underordnad för dessa scheman misslyckas.

Gäller för