WebRequest.RegisterPrefix(String, IWebRequestCreate) Metoda

Definice

Obor názvů:
System.Net
Sestavení:
System.dll, System.Net.Requests.dll
Sestavení:
netstandard.dll, System.Net.Requests.dll
Sestavení:
System.Net.Requests.dll
Sestavení:
System.dll
Sestavení:
netstandard.dll
Zdroj:
WebRequest.cs
Zdroj:
WebRequest.cs
Zdroj:
WebRequest.cs
Zdroj:
WebRequest.cs
Zdroj:
WebRequest.cs

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 potomkové WebRequest služby.

creator
IWebRequestCreate

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

Návraty

Boolean

trueje-li registrace úspěšná; v opačném případě . false

Výjimky

ArgumentNullException

prefix je null

nebo

creator je null.

Poznámky

Caution

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 k žádostem o služby. WebRequest potomky jsou obvykle registrovány pro zpracování konkrétního protokolu, jako je HTTP nebo FTP, ale je možné 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 tématu Create(String) a Create(Uri) metody.

Duplicitní předpony nejsou povoleny. RegisterPrefix vrátí false , pokud se provede pokus o registraci duplicitní předpony.

Note

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

Platí pro