WebRequest.RegisterPrefix(String, IWebRequestCreate) Метод

Определение

Регистрирует потомок WebRequest для заданной схемы 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

Параметры

prefix
String

Полный URI или префикс URI, обслуживаемый потомком WebRequest.The complete URI or URI prefix that the WebRequest descendant services.

creator
IWebRequestCreate

Метод, вызываемый WebRequest для создания потомка WebRequest.The create method that the WebRequest calls to create the WebRequest descendant.

Возвращаемое значение

Значение true, если регистрация успешна; в противном случае — значение false.true if registration is successful; otherwise, false.

Исключения

prefix имеет значение null.prefix is null

-или--or- Параметр creator равен null.creator is null.

Комментарии

Метод RegisterPrefix регистрирует WebRequest потомков для запросов на обслуживание.The RegisterPrefix method registers WebRequest descendants to service requests. WebRequestные потомки обычно регистрируются для работы с конкретным протоколом, таким как HTTP или FTP, но могут быть зарегистрированы для выполнения запроса к определенному серверу или пути на сервере.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.

Уже зарегистрированные предварительно зарегистрированные типы резервов включают следующее:The pre-registered reserve types already registered include the following:

  • http://

  • https://

  • ftp://

  • file://

Дополнительные сведения см. в описании методов Create(String) и Create(Uri).For more information, see the Create(String) and Create(Uri) methods.

Дублирование префиксов не допускается.Duplicate prefixes are not allowed. RegisterPrefix возвращает false при попытке зарегистрировать дублирующийся префикс.RegisterPrefix returns false if an attempt is made to register a duplicate prefix.

Примечание

Класс HttpWebRequest регистрируется в запросах на обслуживание для схем HTTP и HTTPS по умолчанию.The HttpWebRequest class is registered to service requests for HTTP and HTTPS schemes by default. Попытка зарегистрировать другой наследник WebRequest для этих схем завершится ошибкой.Attempts to register a different WebRequest descendant for these schemes will fail.

Применяется к