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 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
true
jeśli rejestracja zakończyła się pomyślnie; w przeciwnym razie , false
.
Wyjątki
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.