HttpClient Classe

Definição

Espaço de Nomes:: System.Net.Http

Assemblagem:: System.Net.Http.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Fornece uma classe para enviar pedidos HTTP e receber respostas HTTP de um recurso identificado por um URI.

public ref class HttpClient : System::Net::Http::HttpMessageInvoker

public class HttpClient : System.Net.Http.HttpMessageInvoker

type HttpClient = class
    inherit HttpMessageInvoker

Public Class HttpClient
Inherits HttpMessageInvoker

Herança: Object

HttpMessageInvoker
HttpClient

Exemplos

// HttpClient is intended to be instantiated once per application, rather than per-use. See Remarks.
static readonly HttpClient client = new HttpClient();

static async Task Main()
{
    // Call asynchronous network methods in a try/catch block to handle exceptions.
    try
    {
        using HttpResponseMessage response = await client.GetAsync("http://www.contoso.com/");
        response.EnsureSuccessStatusCode();
        string responseBody = await response.Content.ReadAsStringAsync();
        // Above three lines can be replaced with new helper method below
        // string responseBody = await client.GetStringAsync(uri);

        Console.WriteLine(responseBody);
    }
    catch (HttpRequestException e)
    {
        Console.WriteLine("\nException Caught!");
        Console.WriteLine("Message :{0} ", e.Message);
    }
}

open System.Net.Http

// HttpClient is intended to be instantiated once per application, rather than per-use. See Remarks.
let client = new HttpClient()

let main =
    task {
        // Call asynchronous network methods in a try/catch block to handle exceptions.
        try
            use! response = client.GetAsync "http://www.contoso.com/"
            response.EnsureSuccessStatusCode() |> ignore
            let! responseBody = response.Content.ReadAsStringAsync()
            // Above three lines can be replaced with new helper method below
            // let! responseBody = client.GetStringAsync uri

            printfn $"{responseBody}"
        with
        | :? HttpRequestException as e ->
            printfn "\nException Caught!"
            printfn $"Message :{e.Message} "
    }

main.Wait()

' HttpClient is intended to be instantiated once per application, rather than per-use. See Remarks.
Shared ReadOnly client As HttpClient = New HttpClient()

Private Shared Async Function Main() As Task
    ' Call asynchronous network methods in a try/catch block to handle exceptions.
    Try
        Using response As HttpResponseMessage = Await client.GetAsync("http://www.contoso.com/")
            response.EnsureSuccessStatusCode()
            Dim responseBody As String = Await response.Content.ReadAsStringAsync()
            ' Above three lines can be replaced with new helper method below
            ' Dim responseBody As String = Await client.GetStringAsync(uri)

            Console.WriteLine(responseBody)
        End Using
    Catch e As HttpRequestException
        Console.WriteLine(Environment.NewLine & "Exception Caught!")
        Console.WriteLine("Message :{0} ", e.Message)
    End Try
End Function

Observações

Para mais informações sobre esta API, consulte Observações suplementares da API para HttpClient.

Construtores

Name	Description
HttpClient()	Inicializa uma nova instância da HttpClient classe usando uma HttpClientHandler que é descartada quando esta instância é descartada.
HttpClient(HttpMessageHandler, Boolean)	Inicializa uma nova instância da HttpClient classe com o handler fornecido e especifica se esse handler deve ser descartado quando essa instância for descartada.
HttpClient(HttpMessageHandler)	Inicializa uma nova instância da HttpClient classe com o handler especificado. O handler é eliminado quando esta instância é descartada.

Propriedades

Name	Description
BaseAddress	Obtém ou define o endereço base do Identificador Uniforme de Recursos (URI) do recurso da Internet utilizado ao enviar pedidos.
DefaultRequestHeaders	Recebe os cabeçalhos que devem ser enviados com cada pedido.
MaxResponseContentBufferSize	Obtém ou define o número máximo de bytes para buffer ao ler o conteúdo da resposta.
Timeout	Obtém ou define o intervalo de tempo para esperar antes do pedido expirar.

Métodos

Name	Description
CancelPendingRequests()	Cancele todos os pedidos pendentes nesta instância.
DeleteAsync(String, CancellationToken)	Enviar um pedido DELETE para o URI especificado com um token de cancelamento como uma operação assíncrona.
DeleteAsync(String)	Enviar um pedido DELETE para o URI especificado como uma operação assíncrona.
DeleteAsync(Uri, CancellationToken)	Enviar um pedido DELETE para o URI especificado com um token de cancelamento como uma operação assíncrona.
DeleteAsync(Uri)	Enviar um pedido DELETE para o URI especificado como uma operação assíncrona.
Dispose()	Liberta os recursos não geridos e dispõe dos recursos geridos usados pelo HttpMessageInvoker. (Herdado de HttpMessageInvoker)
Dispose(Boolean)	Liberta os recursos não geridos usados pelo HttpClient e opcionalmente elimina os recursos geridos.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetAsync(String, CancellationToken)	Enviar um pedido GET para o URI especificado com um token de cancelamento como uma operação assíncrona.
GetAsync(String, HttpCompletionOption, CancellationToken)	Envie um pedido GET para o URI especificado com uma opção de conclusão HTTP e um token de cancelamento como uma operação assíncrona.
GetAsync(String, HttpCompletionOption)	Enviar um pedido GET para o URI especificado com uma opção de conclusão HTTP como uma operação assíncrona.
GetAsync(String)	Enviar um pedido GET para o URI especificado como uma operação assíncrona.
GetAsync(Uri, CancellationToken)	Enviar um pedido GET para o URI especificado com um token de cancelamento como uma operação assíncrona.
GetAsync(Uri, HttpCompletionOption, CancellationToken)	Envie um pedido GET para o URI especificado com uma opção de conclusão HTTP e um token de cancelamento como uma operação assíncrona.
GetAsync(Uri, HttpCompletionOption)	Enviar um pedido GET para o URI especificado com uma opção de conclusão HTTP como uma operação assíncrona.
GetAsync(Uri)	Enviar um pedido GET para o URI especificado como uma operação assíncrona.
GetByteArrayAsync(String)	Envia um pedido GET para o URI especificado e devolve o corpo de resposta como um array de bytes numa operação assíncrona.
GetByteArrayAsync(Uri)	Envie um pedido GET para o URI especificado e retorne o corpo de resposta como um array de bytes numa operação assíncrona.
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetStreamAsync(String)	Envie um pedido GET para o URI especificado e retorne o corpo de resposta como um fluxo numa operação assíncrona.
GetStreamAsync(Uri)	Envie um pedido GET para o URI especificado e retorne o corpo de resposta como um fluxo numa operação assíncrona.
GetStringAsync(String)	Enviar um pedido GET para o URI especificado e devolver o corpo de resposta como uma string numa operação assíncrona.
GetStringAsync(Uri)	Enviar um pedido GET para o URI especificado e devolver o corpo de resposta como uma string numa operação assíncrona.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
PatchAsync(String, HttpContent, CancellationToken)	Envia um pedido PATCH com um token de cancelamento para um URI representado como uma cadeia de caracteres como uma operação assíncrona.
PatchAsync(String, HttpContent)	Envia um pedido PATCH para um URI designado como string como operação assíncrona.
PatchAsync(Uri, HttpContent, CancellationToken)	Envia um pedido PATCH com um token de cancelamento como uma operação assíncrona.
PatchAsync(Uri, HttpContent)	Envia um pedido PATCH como uma operação assíncrona.
PostAsync(String, HttpContent, CancellationToken)	Enviar um pedido POST com um token de cancelamento como uma operação assíncrona.
PostAsync(String, HttpContent)	Enviar um pedido POST ao URI especificado como uma operação assíncrona.
PostAsync(Uri, HttpContent, CancellationToken)	Enviar um pedido POST com um token de cancelamento como uma operação assíncrona.
PostAsync(Uri, HttpContent)	Enviar um pedido POST ao URI especificado como uma operação assíncrona.
PutAsync(String, HttpContent, CancellationToken)	Enviar um pedido PUT com um token de cancelamento como uma operação assíncrona.
PutAsync(String, HttpContent)	Envie um pedido PUT para o URI especificado como uma operação assíncrona.
PutAsync(Uri, HttpContent, CancellationToken)	Enviar um pedido PUT com um token de cancelamento como uma operação assíncrona.
PutAsync(Uri, HttpContent)	Envie um pedido PUT para o URI especificado como uma operação assíncrona.
SendAsync(HttpRequestMessage, CancellationToken)	Enviar um pedido HTTP como uma operação assíncrona.
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)	Enviar um pedido HTTP como uma operação assíncrona.
SendAsync(HttpRequestMessage, HttpCompletionOption)	Enviar um pedido HTTP como uma operação assíncrona.
SendAsync(HttpRequestMessage)	Enviar um pedido HTTP como uma operação assíncrona.
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)

Aplica-se a

Ver também

Comentários

Esta página foi útil?