WebRequest.CreateHttp Метод

Определение

Пространство имен:

System.Net

Сборки:

netstandard.dll, System.Net.Requests.dll

Инициализирует новый экземпляр HttpWebRequest для заданного URI.

Перегрузки

CreateHttp(String)	Устаревшие.. Инициализирует новый экземпляр HttpWebRequest для заданной строки URI.
CreateHttp(Uri)	Устаревшие.. Инициализирует новый экземпляр HttpWebRequest для заданного URI.

CreateHttp(String)

Исходный код:

WebRequest.cs

Внимание!

WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.

Инициализирует новый экземпляр HttpWebRequest для заданной строки URI.

public:
 static System::Net::HttpWebRequest ^ CreateHttp(System::String ^ requestUriString);

[System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static System.Net.HttpWebRequest CreateHttp(string requestUriString);

[<System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member CreateHttp : string -> System.Net.HttpWebRequest

Public Shared Function CreateHttp (requestUriString As String) As HttpWebRequest

Параметры

requestUriString

String

Строка URI, определяющая интернет-ресурс.

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

HttpWebRequest

Экземпляр HttpWebRequest для заданной строки URI.

Атрибуты

ObsoleteAttribute

Исключения

NotSupportedException

Схема запроса, указанная в requestUriString, является схемой http или https.

ArgumentNullException

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

SecurityException

У вызывающего объекта нет разрешения WebPermissionAttribute на подключение к запрошенному универсальному коду ресурса (URI) или к универсальному коду ресурса (URI), к которому перенаправляется запрос.

UriFormatException

Код URI, заданный в requestUriString, является недопустимым.

Комментарии

Метод CreateHttp(String) возвращает экземпляр HttpWebRequest класса для requestUriString.

Когда URI, начинающийся с http:// или https:// , передается в requestUriString параметре , HttpWebRequest возвращается методом CreateHttp(String). Любая другая схема вызовет исключение NotSupportedException.

Метод CreateHttp(String) использует параметр для requestUriString создания экземпляра Uri , который передается в новый HttpWebRequest. Если метод выполнен успешно, свойству AllowReadStreamBuffering возвращаемого HttpWebRequest экземпляра присваивается значение false.

.NET включает поддержку http:// схем URI и https:// . Пользовательские WebRequest потомки для обработки других запросов регистрируются с RegisterPrefix помощью метода . Метод Create(String) можно использовать для создания потомка WebRequest класса для других схем.

CreateHttp(Uri)

Исходный код:

WebRequest.cs

Внимание!

WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.

Инициализирует новый экземпляр HttpWebRequest для заданного URI.

public:
 static System::Net::HttpWebRequest ^ CreateHttp(Uri ^ requestUri);

[System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static System.Net.HttpWebRequest CreateHttp(Uri requestUri);

[<System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member CreateHttp : Uri -> System.Net.HttpWebRequest

Public Shared Function CreateHttp (requestUri As Uri) As HttpWebRequest

Параметры

requestUri

Uri

Идентификатор URI, определяющий интернет-ресурс.

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

HttpWebRequest

Экземпляр HttpWebRequest для заданной строки URI.

Атрибуты

ObsoleteAttribute

Исключения

NotSupportedException

Схема запроса, указанная в requestUri, является схемой http или https.

ArgumentNullException

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

SecurityException

У вызывающего объекта нет разрешения WebPermissionAttribute на подключение к запрошенному универсальному коду ресурса (URI) или к универсальному коду ресурса (URI), к которому перенаправляется запрос.

UriFormatException

Код URI, заданный в requestUri, является недопустимым.

Комментарии

Метод CreateHttp(Uri) возвращает экземпляр HttpWebRequest класса для requestUri.

Когда URI, начинающийся с http:// или http:// , передается в requestUri параметре , HttpWebRequest возвращается CreateHttp(Uri). Другая другая схема вызовет исключение NotSupportedException.

Метод CreateHttp(Uri) использует requestUri параметр для создания нового HttpWebRequest экземпляра . Если метод выполнен успешно, свойству AllowReadStreamBuffering возвращаемого HttpWebRequest экземпляра присваивается значение false.

.NET включает поддержку http:// схем URI и https:// . Пользовательские WebRequest потомки для обработки других запросов регистрируются с RegisterPrefix помощью метода . Метод Create(Uri) можно использовать для создания потомка WebRequest класса для других схем.