System.Net.Http Namespace
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.
Fornece uma interface de programação para aplicativos HTTP modernos.
Classes
| Nome | Description |
|---|---|
| ByteArrayContent |
Fornece conteúdo HTTP com base em uma matriz de bytes. |
| DelegatingHandler |
Um tipo para manipuladores HTTP que delegam o processamento de mensagens de resposta HTTP a outro manipulador, chamado de manipulador interno. |
| FormUrlEncodedContent |
Um contêiner para tuplas de nome/valor codificados usando o tipo MIME de aplicativo/x-www-form-urlencoded. |
| HttpClient |
Fornece uma classe para enviar solicitações HTTP e receber respostas HTTP de um recurso identificado por um URI. |
| HttpClientHandler |
O manipulador de mensagens padrão usado por HttpClient no .NET Framework. |
| HttpContent |
Uma classe base que representa um corpo de entidade HTTP e cabeçalhos de conteúdo. |
| HttpMessageHandler |
Um tipo base para manipuladores de mensagens HTTP. |
| HttpMessageInvoker |
Uma classe de especialidade que permite que os aplicativos chamem o SendAsync(HttpRequestMessage, CancellationToken) método em uma cadeia de manipuladores HTTP. |
| HttpMethod |
Uma classe auxiliar para recuperar e comparar métodos HTTP padrão e para criar novos métodos HTTP. |
| HttpRequestException |
Uma classe base para exceções geradas pelas classes e HttpClient pelas HttpMessageHandler classes. |
| HttpRequestMessage |
Representa uma mensagem de solicitação HTTP. |
| HttpResponseMessage |
Representa uma mensagem de resposta HTTP, incluindo o código de status e os dados. |
| MessageProcessingHandler |
Um tipo base para manipuladores que fazem apenas um pequeno processamento de mensagens de solicitação e/ou resposta. |
| MultipartContent |
Fornece uma coleção de HttpContent objetos que são serializados usando a especificação de tipo de conteúdo multipart/*. |
| MultipartFormDataContent |
Fornece um contêiner para conteúdo codificado usando o tipo MIME multipart/form-data. |
| ReadOnlyMemoryContent |
Fornece conteúdo HTTP com base em um ReadOnlyMemory<T>. |
| RtcRequestFactory |
Fornece uma interface de programação para aplicativos HTTP modernos. |
| StreamContent |
Fornece conteúdo HTTP com base em um fluxo. |
| StringContent |
Fornece conteúdo HTTP com base em uma cadeia de caracteres. |
| WebRequestHandler |
Fornece recursos específicos da área de trabalho não disponíveis para aplicativos da Windows Store ou outros ambientes. |
Enumerações
| Nome | Description |
|---|---|
| ClientCertificateOption |
Especifica como os certificados do cliente são fornecidos. |
| HttpCompletionOption |
Indica se HttpClient operações devem ser consideradas concluídas assim que uma resposta estiver disponível ou depois de ler toda a mensagem de resposta, incluindo o conteúdo. |
Comentários
O System.Net.Http namespace foi projetado para fornecer os seguintes componentes:
- Componentes de cliente HTTP que permitem que os usuários consumam serviços Web modernos por HTTP.
- Componentes HTTP que podem ser usados por clientes e servidores (cabeçalhos HTTP e mensagens, por exemplo). Isso fornece um modelo de programação consistente no lado do cliente e do servidor para serviços Web modernos por HTTP.
O System.Net.Http namespace e o namespace relacionado System.Net.Http.Headers fornecem o seguinte conjunto de componentes:
- HttpClient - A classe primária usada para enviar e receber solicitações por HTTP.
- HttpRequestMessage e HttpResponseMessage – Mensagens HTTP conforme definido no RFC 2616 pelo IETF.
- HttpHeaders - Cabeçalhos HTTP conforme definido no RFC 2616 pelo IETF.
- HttpClientHandler - Manipuladores HTTP responsáveis por produzir mensagens de resposta HTTP.
Há vários manipuladores de mensagens HTTP que você pode usar:
- DelegatingHandler - Uma classe usada para conectar um manipulador a uma cadeia de manipuladores.
- HttpMessageHandler – Uma classe simples a ser derivada disso dá suporte aos requisitos mais comuns para a maioria dos aplicativos.
- HttpClientHandler - Uma classe que opera na parte inferior da cadeia de manipuladores que realmente manipula as operações de transporte HTTP.
O conteúdo de uma mensagem HTTP corresponde ao corpo da entidade definido no RFC 2616.
As seguintes classes podem ser usadas para conteúdo HTTP:
- ByteArrayContent - Conteúdo HTTP com base em uma matriz de bytes.
- FormUrlEncodedContent - Conteúdo HTTP de tuplas de nome/valor codificadas usando o tipo MIME de aplicativo/x-www-form-urlencoded.
- MultipartContent - Conteúdo HTTP que é serializado usando a especificação de tipo de conteúdo multipart/*.
- MultipartFormDataContent - Conteúdo HTTP codificado usando o tipo MIME multipart/form-data.
- StreamContent - Conteúdo HTTP com base em um fluxo.
- StringContent - Conteúdo HTTP com base em uma cadeia de caracteres.
Se o aplicativo usa os System.Net.Http namespaces e System.Net.Http.Headers pretende baixar grandes quantidades de dados (50 megabytes ou mais), ele deve transmitir esses downloads e não usar o buffer padrão. Se você usar o buffer padrão, o uso da memória do cliente ficará muito grande, potencialmente resultando em um desempenho substancialmente reduzido.