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

Определение

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

creator
IWebRequestCreate

Метод, вызываемый WebRequest для создания потомка WebRequest.

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

Boolean

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

Исключения

prefix равно null

-или- creator имеет значение null.

Комментарии

Метод RegisterPrefix регистрирует WebRequest потомков в запросах на обслуживание. WebRequest потомки обычно регистрируются для обработки определенного протокола, такого как HTTP или FTP, но могут быть зарегистрированы для обработки запроса к определенному серверу или пути на сервере.

Предварительно зарегистрированные типы резервов уже зарегистрированы:

  • http://

  • https://

  • ftp://

  • file://

Дополнительные сведения см. в описании Create(String) и Create(Uri) методах.

Повторяющиеся префиксы запрещены. RegisterPrefix возвращает значение, false если предпринята попытка зарегистрировать повторяющийся префикс.

Примечание

Класс HttpWebRequest регистрируется в запросах службы для схем HTTP и HTTPS по умолчанию. Попытки регистрации другого WebRequest потомка для этих схем завершаются ошибкой.

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