Compartilhar via


WebRequest.CreateHttp Método

Definição

Inicializa uma nova instância HttpWebRequest para o URI especificado.

Sobrecargas

CreateHttp(String)
Obsoleto.

Inicializa uma nova instância HttpWebRequest com a cadeia de caracteres de URI especificada.

CreateHttp(Uri)
Obsoleto.

Inicializa uma nova instância HttpWebRequest para o URI especificado.

CreateHttp(String)

Origem:
WebRequest.cs
Origem:
WebRequest.cs
Origem:
WebRequest.cs

Cuidado

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

Inicializa uma nova instância HttpWebRequest com a cadeia de caracteres de URI especificada.

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

Parâmetros

requestUriString
String

Um URI que identifica o recurso da Internet.

Retornos

Uma instância HttpWebRequest da cadeia de caracteres de URI específica.

Atributos

Exceções

O esquema de solicitação especificado no requestUriString é o esquema HTTP ou HTTPS.

requestUriString é null.

O chamador não tem a permissão WebPermissionAttribute para se conectar ao URI solicitado ou a um URI a que a solicitação é redirecionada.

O URI especificado em requestUriString não é um URI válido.

Comentários

O CreateHttp(String) método retorna uma instância da HttpWebRequest classe para o requestUriString.

Quando um URI que começa com http:// ou é passado no requestUriString parâmetro , um HttpWebRequest é retornado por CreateHttp(String)https:// . Qualquer outro esquema lançará um NotSupportedException.

O CreateHttp(String) método usa o requestUriString parâmetro para criar uma Uri instância que ele passa para o novo HttpWebRequest. Se o método for bem-sucedido, a AllowReadStreamBuffering propriedade na instância retornada HttpWebRequest será definida como false.

O .NET inclui suporte para os http:// esquemas de URI e https:// . Descendentes personalizados WebRequest para lidar com outras solicitações são registrados com o RegisterPrefix método . O Create(String) método pode ser usado para criar um descendente da WebRequest classe para outros esquemas.

Aplica-se a

CreateHttp(Uri)

Origem:
WebRequest.cs
Origem:
WebRequest.cs
Origem:
WebRequest.cs

Cuidado

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

Inicializa uma nova instância HttpWebRequest para o URI especificado.

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

Parâmetros

requestUri
Uri

Um URI que identifica o recurso da Internet.

Retornos

Uma instância HttpWebRequest da cadeia de caracteres de URI específica.

Atributos

Exceções

O esquema de solicitação especificado no requestUri é o esquema HTTP ou HTTPS.

requestUri é null.

O chamador não tem a permissão WebPermissionAttribute para se conectar ao URI solicitado ou a um URI a que a solicitação é redirecionada.

O URI especificado em requestUri não é um URI válido.

Comentários

O CreateHttp(Uri) método retorna uma instância da HttpWebRequest classe para o requestUri.

Quando um URI que começa com http:// ou é passado no requestUri parâmetro , um HttpWebRequest é retornado por CreateHttp(Uri)http:// . Outro outro esquema lançará um NotSupportedException.

O CreateHttp(Uri) método usa o requestUri parâmetro para criar uma nova HttpWebRequest instância. Se o método for bem-sucedido, a AllowReadStreamBuffering propriedade na instância retornada HttpWebRequest será definida como false.

O .NET inclui suporte para os http:// esquemas de URI e https:// . Descendentes personalizados WebRequest para lidar com outras solicitações são registrados com o RegisterPrefix método . O Create(Uri) método pode ser usado para criar um descendente da WebRequest classe para outros esquemas.

Aplica-se a