WebRequest.RegisterPrefix(String, IWebRequestCreate) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
Poznámky
Opatrnost
WebRequest
, HttpWebRequest
, ServicePoint
a 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.