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 потомок для этих схем завершатся ошибкой.

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