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
.
Исключения
Комментарии
Осторожность
WebRequest
, HttpWebRequest
, ServicePoint
и WebClient
устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Метод RegisterPrefix регистрирует WebRequest потомков в запросах на обслуживание. WebRequest потомки обычно регистрируются для обработки определенного протокола, например HTTP или FTP, но могут быть зарегистрированы для обработки запроса к конкретному серверу или пути на сервере.
Типы предварительно зарегистрированных резервов уже зарегистрированы:
http://
https://
ftp://
file://
Дополнительные сведения см. в Create(String) и методах Create(Uri).
Повторяющиеся префиксы запрещены.
RegisterPrefix возвращает false
, если предпринята попытка зарегистрировать повторяющийся префикс.
Заметка
Класс HttpWebRequest зарегистрирован в запросах службы для схем HTTP и HTTPS по умолчанию. Попытки регистрации другого WebRequest потомка для этих схем завершаются ошибкой.