WebRequest.CreateHttp Метод

Определение

Инициализирует новый экземпляр HttpWebRequest для заданного URI.Initializes a new HttpWebRequest instance for the specified URI.

Перегрузки

CreateHttp(String)

Инициализирует новый экземпляр HttpWebRequest для заданной строки URI.Initializes a new HttpWebRequest instance for the specified URI string.

CreateHttp(Uri)

Инициализирует новый экземпляр HttpWebRequest для заданного URI.Initializes a new HttpWebRequest instance for the specified URI.

CreateHttp(String)

Инициализирует новый экземпляр HttpWebRequest для заданной строки URI.Initializes a new HttpWebRequest instance for the specified URI string.

public:
 static System::Net::HttpWebRequest ^ CreateHttp(System::String ^ requestUriString);
public static System.Net.HttpWebRequest CreateHttp (string requestUriString);
static member CreateHttp : string -> System.Net.HttpWebRequest
Public Shared Function CreateHttp (requestUriString As String) As HttpWebRequest

Параметры

requestUriString
String

Строка URI, определяющая интернет-ресурс.A URI string that identifies the Internet resource.

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

Экземпляр HttpWebRequest для заданной строки URI.An HttpWebRequest instance for the specific URI string.

Исключения

Схема запроса, указанная в requestUriString, является схемой http или https.The request scheme specified in requestUriString is the http or https scheme.

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

У вызывающего объекта нет разрешения WebPermissionAttribute на подключение к запрошенному универсальному коду ресурса (URI) или к универсальному коду ресурса (URI), к которому перенаправляется запрос.The caller does not have WebPermissionAttribute permission to connect to the requested URI or a URI that the request is redirected to.

Код URI, заданный в requestUriString, является недопустимым.The URI specified in requestUriString is not a valid URI.

Комментарии

Метод CreateHttp(String) возвращает экземпляр класса HttpWebRequest для requestUriString.The CreateHttp(String) method returns an instance of the HttpWebRequest class for the requestUriString.

Если URI, начинающийся с http:// или https://, передается в параметр requestUriString, CreateHttp(String)возвращается HttpWebRequest.When a URI that begins with http:// or https:// is passed in the requestUriString parameter, a HttpWebRequest is returned by CreateHttp(String). Любая другая схема вызовет исключение NotSupportedException.Any other scheme will throw a NotSupportedException.

Метод CreateHttp(String) использует параметр requestUriString для создания Uri экземпляра, который передается в новый HttpWebRequest.The CreateHttp(String) method uses the requestUriString parameter to create a Uri instance that it passes to the new HttpWebRequest. Если метод выполнен успешно, свойству AllowReadStreamBuffering в возвращаемом HttpWebRequest экземпляре присваивается значение false.If the method is successful, the AllowReadStreamBuffering property on the returned HttpWebRequest instance is set to false.

.NET включает поддержку http:// и https:// схем URI..NET includes support for the http:// and https:// URI schemes. Пользовательские WebRequest потомков для обработки других запросов регистрируются с помощью метода RegisterPrefix.Custom WebRequest descendants to handle other requests are registered with the RegisterPrefix method. Метод Create(String) можно использовать для создания потомка класса WebRequest для других схем.The Create(String) method can be used to create a descendant of the WebRequest class for other schemes.

CreateHttp(Uri)

Инициализирует новый экземпляр HttpWebRequest для заданного URI.Initializes a new HttpWebRequest instance for the specified URI.

public:
 static System::Net::HttpWebRequest ^ CreateHttp(Uri ^ requestUri);
public static System.Net.HttpWebRequest CreateHttp (Uri requestUri);
static member CreateHttp : Uri -> System.Net.HttpWebRequest
Public Shared Function CreateHttp (requestUri As Uri) As HttpWebRequest

Параметры

requestUri
Uri

Идентификатор URI, определяющий интернет-ресурс.A URI that identifies the Internet resource.

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

Экземпляр HttpWebRequest для заданной строки URI.An HttpWebRequest instance for the specific URI string.

Исключения

Схема запроса, указанная в requestUri, является схемой http или https.The request scheme specified in requestUri is the http or https scheme.

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

У вызывающего объекта нет разрешения WebPermissionAttribute на подключение к запрошенному универсальному коду ресурса (URI) или к универсальному коду ресурса (URI), к которому перенаправляется запрос.The caller does not have WebPermissionAttribute permission to connect to the requested URI or a URI that the request is redirected to.

Код URI, заданный в requestUri, является недопустимым.The URI specified in requestUri is not a valid URI.

Комментарии

Метод CreateHttp(Uri) возвращает экземпляр класса HttpWebRequest для requestUri.The CreateHttp(Uri) method returns an instance of the HttpWebRequest class for the requestUri.

Если URI, начинающийся с http:// или http://, передается в параметр requestUri, CreateHttp(Uri)возвращается HttpWebRequest.When a URI that begins with http:// or http:// is passed in the requestUri parameter, an HttpWebRequest is returned by CreateHttp(Uri). Другая схема вызовет исключение NotSupportedException.Another other scheme will throw a NotSupportedException.

Метод CreateHttp(Uri) использует параметр requestUri для создания нового экземпляра HttpWebRequest.The CreateHttp(Uri) method uses the requestUri parameter to create a new HttpWebRequest instance. Если метод выполнен успешно, свойству AllowReadStreamBuffering в возвращаемом HttpWebRequest экземпляре присваивается значение false.If the method is successful, the AllowReadStreamBuffering property on the returned HttpWebRequest instance is set to false.

.NET включает поддержку http:// и https:// схем URI..NET includes support for the http:// and https:// URI schemes. Пользовательские WebRequest потомков для обработки других запросов регистрируются с помощью метода RegisterPrefix.Custom WebRequest descendants to handle other requests are registered with the RegisterPrefix method. Метод Create(Uri) можно использовать для создания потомка класса WebRequest для других схем.The Create(Uri) method can be used to create a descendant of the WebRequest class for other schemes.

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