Partilhar via


WebRequest.CreateHttp Método

Definição

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

Sobrecargas

Nome Description
CreateHttp(String)
Obsoleto.

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

CreateHttp(Uri)
Obsoleto.

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

CreateHttp(String)

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

Cuidado

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

Inicializa uma nova HttpWebRequest instância para 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

Uma cadeia de caracteres de URI que identifica o recurso da Internet.

Retornos

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

Atributos

Exceções

O esquema de solicitação especificado é requestUriString o esquema http ou https.

requestUriString é null.

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

O URI especificado não requestUriString é 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:// URI. 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
Origem:
WebRequest.cs
Origem:
WebRequest.cs

Cuidado

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

Inicializa uma nova HttpWebRequest instância 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 HttpWebRequest instância para a cadeia de caracteres de URI específica.

Atributos

Exceções

O esquema de solicitação especificado é requestUri o esquema http ou https.

requestUri é null.

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

O URI especificado não requestUri é 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:// URI. 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