Поделиться через


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.

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

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

Исключения

prefix null

-или-

creator null.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.

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

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

  • http://

  • https://

  • ftp://

  • file://

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

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

Заметка

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

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