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

  • Ссылка

Определение

Пространство имен:
System.Net
Сборка:
System.Net.Requests.dll
Сборка:
System.dll
Сборка:
netstandard.dll
Исходный код:
WebRequest.cs
Исходный код:
WebRequest.cs
Исходный код:
WebRequest.cs

Регистрирует потомок 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.

Исключения

ArgumentNullException

prefix равно null

-или-

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

Комментарии

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

К уже зарегистрированным типам предварительно зарегистрированных резервов относятся следующие.

  • http://

  • https://

  • ftp://

  • file://

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

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

Примечание

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

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