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

Указанный в requestUriString URI не является допустимым универсальным кодом ресурса (URI).

Комментарии

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

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

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

.NET включает поддержку http:// схем URI и https:// URI. Пользовательские 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

Указанный в requestUri URI не является допустимым универсальным кодом ресурса (URI).

Комментарии

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

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

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

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