Sdílet prostřednictvím


WebRequest.RegisterPrefix(String, IWebRequestCreate) Metoda

Definice

Zaregistruje WebRequest potomka pro zadaný identifikátor 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

Parametry

prefix
String

Kompletní předpona identifikátoru URI nebo identifikátoru URI, kterou WebRequest potomkové služby.

creator
IWebRequestCreate

Metoda create, kterou WebRequest volá k vytvoření WebRequest potomka.

Návraty

true, pokud registrace proběhne úspěšně; jinak false.

Výjimky

prefix je null

-nebo-

creator je null.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Metoda RegisterPrefix zaregistruje WebRequest potomky do žádostí o služby. WebRequest potomky jsou obvykle registrovány ke zpracování konkrétního protokolu, jako je HTTP nebo FTP, ale lze je zaregistrovat ke zpracování požadavku na konkrétní server nebo cestu na serveru.

Předem zaregistrované typy rezerv zahrnují následující:

  • http://

  • https://

  • ftp://

  • file://

Další informace najdete v Create(String) a metodách Create(Uri).

Duplicitní předpony nejsou povoleny. RegisterPrefix vrátí false v případě pokusu o registraci duplicitní předpony.

Poznámka

Třída HttpWebRequest je ve výchozím nastavení zaregistrovaná v žádostech o služby pro schémata HTTP a HTTPS. Pokusy o registraci jiného WebRequest potomka pro tato schémata selžou.

Platí pro