HttpClient.DefaultRequestHeaders Propiedad

Definición

Obtiene una colección de encabezados que se deben enviar con cada solicitud. Para obtener instrucciones de programación para la clase HttpClient y ejemplos de código, consulte el tema conceptual HttpClient .

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

Valor de propiedad

Encabezados que se deben enviar con cada solicitud.

Comentarios

La propiedad DefaultRequestHeaders devuelve un objeto HttpRequestHeaderCollection que se puede usar para obtener o establecer los encabezados específicos en la instancia de HttpClient . Los encabezados HTTP establecidos en esta propiedad se enviarán en todos los mensajes de solicitud enviados en esta instancia httpClient y no es necesario establecerlos en cada instancia httpRequestMessage .

La propiedad Headers del objeto HttpRequestMessage devuelve un objeto HttpRequestHeaderCollection que se puede usar para obtener o establecer los encabezados específicos en una solicitud HTTP específica.

La propiedad DefaultRequestHeaders representa los encabezados que un desarrollador de aplicaciones puede establecer, no todos los encabezados que finalmente se pueden enviar con la solicitud. HttpBaseProtocolFilter agregará algunos encabezados adicionales.

Advertencia

En versiones anteriores a Windows 10, establecer determinados encabezados en NULL provocaba que se establecera un valor de encabezado vacío, lo que provocó un error inesperado en las llamadas posteriores a GetAsync. A partir de Windows 10, establecer cualquiera de los siguientes encabezados en NULL hace que se quiten por completo de la solicitud, de modo que los encabezados restantes sean válidos.

  • Authorization
  • Date
  • Desde
  • administrador de flujos de trabajo
  • If-Modified-Since
  • If-Unmodified-Since
  • Max-Forwards
  • Proxy-Authorization
  • Referer

Si está escribiendo para versiones anteriores a Windows 10, no establezca estos valores de encabezado en NULL.

Se aplica a

Consulte también