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 , если предпринята попытка зарегистрировать повторяющийся префикс.

Note

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

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