WebRequest.CreateHttp Método

Definição

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

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

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);

[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);

[<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

HttpWebRequest

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

Atributos

ObsoleteAttribute

Exceções

NotSupportedException

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

ArgumentNullException

requestUriString é null.

SecurityException

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.

UriFormatException

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 falsecomo .

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.

CreateHttp(Uri)

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);

[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);

[<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

HttpWebRequest

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

Atributos

ObsoleteAttribute

Exceções

NotSupportedException

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

ArgumentNullException

requestUri é null.

SecurityException

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.

UriFormatException

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 falsecomo .

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.