HttpClient.DefaultRequestHeaders Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 HttpRequestHeaderCollectionValor 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.