WebRequest.RegisterPrefix(String, IWebRequestCreate) Metoda

Definicja

Namespace:

System.Net

Zestawów:

netstandard.dll, System.Net.Requests.dll

Źródło:

WebRequest.cs

Rejestruje element podrzędny WebRequest dla określonego identyfikatora 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

Pełny identyfikator URI lub prefiks identyfikatora URI, który WebRequest usług podrzędnych.

creator

IWebRequestCreate

Metoda create wywoływana przez WebRequest w celu utworzenia elementu podrzędnego WebRequest.

Zwraca

Boolean

true, jeśli rejestracja zakończyła się pomyślnie; w przeciwnym razie false.

Wyjątki

ArgumentNullException

prefix jest null

-lub-

creator jest null.

Uwagi

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Metoda RegisterPrefix rejestruje obiekty podrzędne WebRequest do żądań obsługi. WebRequest obiekty podrzędne są zwykle rejestrowane w celu obsługi określonego protokołu, takiego jak HTTP lub FTP, ale można je zarejestrować w celu obsługi żądania do określonego serwera lub ścieżki na serwerze.

Zarejestrowane wcześniej typy rezerw obejmują następujące elementy:

• http://

• https://

• ftp://

• file://

Aby uzyskać więcej informacji, zobacz metody Create(String) i Create(Uri).

Zduplikowane prefiksy są niedozwolone. RegisterPrefix zwraca false, jeśli podjęto próbę zarejestrowania zduplikowanego prefiksu.

Nuta

Klasa HttpWebRequest jest domyślnie rejestrowana w żądaniach obsługi schematów HTTP i HTTPS. Próba zarejestrowania innego elementu podrzędnego WebRequest dla tych schematów zakończy się niepowodzeniem.