Compartilhar via


HttpClient.DefaultRequestHeaders Propriedade

Definição

Obtém uma coleção de cabeçalhos que devem ser enviados com cada solicitação. Para obter diretrizes de programação para a classe HttpClient e exemplos de código, consulte o tópico conceitual HttpClient .

public:
 property HttpRequestHeaderCollection ^ DefaultRequestHeaders { HttpRequestHeaderCollection ^ get(); };
HttpRequestHeaderCollection DefaultRequestHeaders();
public HttpRequestHeaderCollection DefaultRequestHeaders { get; }
var httpRequestHeaderCollection = httpClient.defaultRequestHeaders;
Public ReadOnly Property DefaultRequestHeaders As HttpRequestHeaderCollection

Valor da propriedade

Os cabeçalhos que devem ser enviados com cada solicitação.

Comentários

A propriedade DefaultRequestHeaders retorna um objeto HttpRequestHeaderCollection que pode ser usado para obter ou definir os cabeçalhos específicos na instância httpClient . Os cabeçalhos HTTP definidos nessa propriedade serão enviados em todas as mensagens de solicitação enviadas nesta instância httpClient e não precisarão ser definidos em cada instância httpRequestMessage .

A propriedade Headers no objeto HttpRequestMessage retorna um objeto HttpRequestHeaderCollection que pode ser usado para obter ou definir os cabeçalhos específicos em uma solicitação HTTP específica.

A propriedade DefaultRequestHeaders representa os cabeçalhos que um desenvolvedor de aplicativos pode definir, nem todos os cabeçalhos que podem eventualmente ser enviados com a solicitação. O HttpBaseProtocolFilter adicionará alguns cabeçalhos adicionais.

Aviso

Em versões anteriores ao Windows 10, definir determinados cabeçalhos como NULL fazia com que um valor de cabeçalho vazio fosse definido, o que causou uma falha inesperada nas chamadas subsequentes para GetAsync. A partir do Windows 10, definir qualquer um dos cabeçalhos a seguir como NULL faz com que eles sejam removidos totalmente da solicitação, de modo que os cabeçalhos restantes sejam válidos.

  • Autorização
  • Data
  • De
  • Host
  • If-Modified-Since
  • If-Unmodified-Since
  • Max-Forwards
  • Proxy-Authorization
  • Referer

Se você estiver escrevendo para versões antes do Windows 10, não defina esses valores de cabeçalho como NULL.

Aplica-se a

Confira também