HttpClient.DefaultRequestHeaders Propriedade

Definição

Namespace:

Windows.Web.Http

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

HttpRequestHeaderCollection

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.

Confira também

• HttpClient