WebRequest.RegisterPrefix(String, IWebRequestCreate) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Net

Zestaw:: System.Net.Requests.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Rejestruje element WebRequest podrzędny 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

Kompletny prefiks identyfikatora URI lub identyfikatora URI, który usługi podrzędne WebRequest .

creator: IWebRequestCreate

Metoda create wywoływana WebRequest przez wywołanie elementu podrzędnego WebRequest .

Zwraca

Boolean

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

Wyjątki

ArgumentNullException

prefix to null

-lub- creator to null.

Uwagi

Metoda RegisterPrefix rejestruje elementy podrzędne WebRequest w żądaniach 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 typy rezerw wstępnie zarejestrowane obejmują następujące elementy:

http://
https://
ftp://
file://

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

Zduplikowane prefiksy nie są dozwolone. RegisterPrefix Zwraca wartość false , jeśli podjęto próbę zarejestrowania zduplikowanego prefiksu.

Uwaga

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

Dotyczy