WebRequest.CreateHttp Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Инициализирует новый экземпляр HttpWebRequest для заданного URI.
Перегрузки
CreateHttp(String) |
Устаревшие..
Инициализирует новый экземпляр HttpWebRequest для заданной строки URI. |
CreateHttp(Uri) |
Устаревшие..
Инициализирует новый экземпляр HttpWebRequest для заданного URI. |
CreateHttp(String)
- Исходный код:
- WebRequest.cs
- Исходный код:
- WebRequest.cs
- Исходный код:
- WebRequest.cs
Внимание!
WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.
Инициализирует новый экземпляр HttpWebRequest для заданной строки URI.
public:
static System::Net::HttpWebRequest ^ CreateHttp(System::String ^ requestUriString);
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}")]
public static System.Net.HttpWebRequest CreateHttp (string requestUriString);
static member CreateHttp : string -> System.Net.HttpWebRequest
[<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 для заданной строки URI.
- Атрибуты
Исключения
Схема запроса, указанная в requestUriString
, является схемой http или https.
requestUriString
имеет значение null
.
У вызывающего объекта нет разрешения WebPermissionAttribute на подключение к запрошенному универсальному коду ресурса (URI) или к универсальному коду ресурса (URI), к которому перенаправляется запрос.
Код 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.cs
- Исходный код:
- WebRequest.cs
Внимание!
WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.
Инициализирует новый экземпляр HttpWebRequest для заданного URI.
public:
static System::Net::HttpWebRequest ^ CreateHttp(Uri ^ requestUri);
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);
static member CreateHttp : Uri -> System.Net.HttpWebRequest
[<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 для заданной строки URI.
- Атрибуты
Исключения
Схема запроса, указанная в requestUri
, является схемой http или https.
requestUri
имеет значение null
.
У вызывающего объекта нет разрешения WebPermissionAttribute на подключение к запрошенному универсальному коду ресурса (URI) или к универсальному коду ресурса (URI), к которому перенаправляется запрос.
Код 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 класса для других схем.