WebRequest.RegisterPrefix(String, IWebRequestCreate) Metoda

Definicja

Rejestruje element podrzędny WebRequest dla określonego identyfikatora URI.Registers a WebRequest descendant for the specified 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 WebRequest usług podrzędnych.The complete URI or URI prefix that the WebRequest descendant services.

creator
IWebRequestCreate

Metoda tworzenia, którą WebRequest wywołuje, aby utworzyć WebRequest elementu podrzędnego.The create method that the WebRequest calls to create the WebRequest descendant.

Zwraca

Boolean

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

Wyjątki

prefix jest nullprefix is null

— lub —-or- Parametr creator ma wartość null.creator is null.

Uwagi

Metoda RegisterPrefix rejestruje WebRequest elementy podrzędne do żądania obsługi.The RegisterPrefix method registers WebRequest descendants to service requests. elementy podrzędne WebRequest są zwykle zarejestrowane do obsługi określonego protokołu, takiego jak HTTP lub FTP, ale mogą być zarejestrowane w celu obsługi żądania do określonego serwera lub ścieżki na serwerze.WebRequest descendants are typically registered to handle a specific protocol, such HTTP or FTP, but can be registered to handle a request to a specific server or path on a server.

Zarejestrowane wstępnie zarejestrowane typy rezerwacji obejmują następujące elementy:The pre-registered reserve types already registered include the following:

  • http://

  • https://

  • ftp://

  • file://

Aby uzyskać więcej informacji, zobacz Metody Create(String) i Create(Uri).For more information, see the Create(String) and Create(Uri) methods.

Zduplikowane prefiksy są niedozwolone.Duplicate prefixes are not allowed. RegisterPrefix zwraca false, Jeśli podjęto próbę zarejestrowania zduplikowanego prefiksu.RegisterPrefix returns false if an attempt is made to register a duplicate prefix.

Uwaga

Klasa HttpWebRequest jest domyślnie zarejestrowana w żądaniach obsługi dla schematów HTTP i HTTPS.The HttpWebRequest class is registered to service requests for HTTP and HTTPS schemes by default. Próby zarejestrowania innego elementu podrzędnego WebRequest dla tych schematów zakończą się niepowodzeniem.Attempts to register a different WebRequest descendant for these schemes will fail.

Dotyczy