WebRequest.RegisterPrefix(String, IWebRequestCreate) Metoda
Definicja
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 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 -> boolPublic Shared Function RegisterPrefix (prefix As String, creator As IWebRequestCreate) As BooleanParametry
- 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
true, jeśli rejestracja zakończyła się pomyślnie; w przeciwnym razie false.
Wyjątki
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.
