WebRequest.CreateHttp Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.