HttpHeader
class HttpHeader
Module: System.Web.Http
Assembly: System.Web.dll
Source file: HttpClient.rvn
Inheritance: Object → HttpHeader
An HTTP header name and value. Socket parsing lowercases names and trims surrounding spaces/tabs from values.
Remarks
Development after Preview 9. Expected HTTP failures use the HttpError union, preserving DNS and socket causes. The socket transport admits HTTP/1.1 final statuses 200–599 using Content-Length, bounded chunked or close-delimited framing; HEAD/204/304 complete after headers, at most 2,048 header bytes, 16 fields and 1,024 body bytes. Chunk metadata is limited to 2,048 bytes; extensions and trailers are unsupported. HTTPS requires explicit SslClientAuthenticationOptions through HttpSocketHandler. No pooling, redirects, unknown-length uploads, streaming responses or informational responses. Known-length stream uploads are limited to 65,536 bytes; buffered requests and received bodies retain their 1,024-byte limit. HttpClient.Timeout covers the complete handler pipeline through buffered response completion and defaults to 100 seconds. None disables the client countdown. DNS, connect and transfers retain independent five-second phase bounds, so transport failures can occur earlier. Direct HttpSocketHandler use has no client-wide countdown. Cancellation and expiry require scheduler progress and provider cleanup acknowledgement. See the Web feature guide for contracts and limits.