HttpClient Classe

Definição

public ref class HttpClient sealed : IClosable, IStringable

/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Web.Http.IHttpClientFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class HttpClient final : IClosable, IStringable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.Web.Http.IHttpClientFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class HttpClient final : IClosable, IStringable

[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Web.Http.IHttpClientFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class HttpClient : System.IDisposable, IStringable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Web.Http.IHttpClientFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class HttpClient : System.IDisposable, IStringable

function HttpClient(filter)

Public NotInheritable Class HttpClient
Implements IDisposable, IStringable

Herança

Object Platform::Object IInspectable HttpClient

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

IClosable IDisposable IStringable

Requisitos do Windows

Exemplos

O código de exemplo a seguir mostra como OBTER conteúdo de um servidor Web como uma cadeia de caracteres.

using System;

var uri = new System.Uri("http://www.bing.com");
using (var httpClient = new Windows.Web.Http.HttpClient())
{
    // Always catch network exceptions for async methods
    try
    {
        string result = await httpClient.GetStringAsync(uri);
    }
    catch (Exception ex)
    {
        // Details in ex.Message and ex.HResult.
    }
}
// Having exited the scope of the using statement, httpClient.Dispose() will be called
// automatically, thus freeing up system resources (the underlying socket, and memory
// used for the object).

#include "winrt/Windows.Foundation.h"
#include "winrt/Windows.Web.Http.h"
using namespace winrt;

Windows::Foundation::IAsyncAction HttpClientExample()
{
    Windows::Foundation::Uri uri{ L"http://www.bing.com" };
    Windows::Web::Http::HttpClient httpClient{};

    // Always catch network exceptions for async methods
    try
    {
        auto response{ co_await httpClient.GetStringAsync(uri) };
    }
    catch (winrt::hresult_error const& ex)
    {
        // Details in ex.message() and ex.to_abi().
    }

    // The destructor of HttpClient frees system resources
    // (the underlying socket, and memory used for the object).
}

using namespace Windows::Foundation;
using namespace Windows::Web::Http;

uri = ref new Uri("http://example.com/datalist.aspx");
httpClient = ref new HttpClient();

// Always catch network exceptions for async methods
try 
{
    httpClient->GetStringAsync(uri);
}
catch 
{
    // Details in ex.Message and ex.HResult.   
}

// In C++/CX, the system resources used by httpClient object are released 
// when the object falls out of scope or by the destructor (delete operator).

A classe HttpClient geralmente é usada por um aplicativo para baixar e, em seguida, analisar texto. É possível que a codificação de caracteres especificada no cabeçalho Tipo de Conteúdo por um servidor HTTP não corresponda à codificação de caracteres do corpo da resposta HTTP (a codificação XML em um documento XML, por exemplo). Uma maneira de usar HttpClient com texto é chamar o método GetStringAsync e passar a cadeia de caracteres retornada para o analisador de texto. No entanto, isso poderá resultar em erros se o Tipo de Conteúdo não for um tipo expressível como uma cadeia de caracteres. Uma maneira confiável de usar HttpClient com um analisador XML é chamar o método GetBufferAsync e analisar o buffer para o elemento "<?xml>". Em seguida, use a codificação de caracteres especificada ("<xmlversion="1.0" encoding="UTF-8"?>", por exemplo) para analisar o corpo da resposta HTTP. Para outros formatos de texto, métodos semelhantes podem ser usados em que o aplicativo examina a parte inicial do corpo da resposta HTTP para determinar a codificação de caracteres usada.

Comentários

A instância da classe HttpClient atua como uma sessão para enviar solicitações HTTP e receber respostas. Uma instância httpClient é uma coleção de configurações que se aplicam a todas as solicitações executadas por essa instância. Além disso, cada instância httpClient usa seu próprio pool de conexões, isolando suas solicitações de solicitações executadas por outras instâncias httpClient.

O HttpClient também atua como uma classe a ser usada com filtros para clientes HTTP mais específicos. Um exemplo seria um HttpClientFilter que fornece métodos adicionais específicos para um serviço de rede social (um método GetFriends, por exemplo).

Se um aplicativo que usa HttpClient e classes relacionadas no namespace Windows.Web.Http baixar grandes quantidades de dados (50 megabytes ou mais), o aplicativo deverá transmitir esses downloads e não usar o buffer padrão. Se o buffer padrão for usado, o uso de memória do cliente ficará muito grande, potencialmente resultando em desempenho reduzido.

Para obter um código de exemplo em C# e C++/WinRT que mostra como usar HttpClient para se conectar a um servidor HTTP, consulte HttpClient.

Para obter um código de exemplo em JavaScript e HTML que mostra como usar HttpClient para se conectar a um servidor HTTP, consulte Conectando-se a um servidor HTTP usando Windows.Web.Http.

Histórico de versão

Construtores

Propriedades

Métodos

Aplica-se a

Confira também

• IClosable
• IStringable
• Uri
• Windows.Web.Http
• Windows.Web.Http.Filters
• Windows.Web.Http.Headers
• HttpClient
• Conectando-se a um servidor HTTP usando Windows.Web.Http
• Tratamento de exceções em aplicativos de rede
• System.Uri
• Exemplo de transferência em segundo plano
• Exemplo de transferência em segundo plano (Windows 8.x)
• Exemplo de HttpClient (Windows 10)
• Exemplo de JSON (Windows 10)