默认 HTTP 头是否有任何常量?

Microsoft 是否为标准 HTTP 头名创建了一个包含常量的类,还是我必须自己编写?

36052 次浏览

Request Headers

/// <summary>
/// Contains the standard set of headers applicable to an HTTP request.
/// </summary>
public static class HttpRequestHeaders
{
///<summary>Content-Types that are acceptable</summary>
public const string Accept = "Accept";
///<summary>Character sets that are acceptable</summary>
public const string AcceptCharset = "Accept-Charset";
///<summary>Acceptable encodings. See HTTP compression.</summary>
public const string AcceptEncoding = "Accept-Encoding";
///<summary>Acceptable languages for response</summary>
public const string AcceptLanguage = "Accept-Language";
///<summary>Acceptable version in time</summary>
public const string AcceptDatetime = "Accept-Datetime";
///<summary>Authentication credentials for HTTP authentication</summary>
public const string Authorization = "Authorization";
///<summary>Used to specify directives that MUST be obeyed by all caching mechanisms along the request/response chain</summary>
public const string CacheControl = "Cache-Control";
///<summary>What type of connection the user-agent would prefer</summary>
public const string Connection = "Connection";
///<summary>an HTTP cookie previously sent by the server with Set-Cookie (below)</summary>
public const string Cookie = "Cookie";
///<summary>The length of the request body in octets (8-bit bytes)</summary>
public const string ContentLength = "Content-Length";
///<summary>A Base64-encoded binary MD5 sum of the content of the request body</summary>
public const string ContentMD5 = "Content-MD5";
///<summary>The MIME type of the body of the request (used with POST and PUT requests)</summary>
public const string ContentType = "Content-Type";
///<summary>The date and time that the message was sent</summary>
public const string Date = "Date";
///<summary>Indicates that particular server behaviors are required by the client</summary>
public const string Expect = "Expect";
///<summary>The email address of the user making the request</summary>
public const string From = "From";
///<summary>The domain name of the server (for virtual hosting), mandatory since HTTP/1.1. Although domain name are specified as case-insensitive[5][6], it is not specified whether the contents of the Host field should be interpreted in a case-insensitive manner[7] and in practice some implementations of virtual hosting interpret the contents of the Host field in a case-sensitive manner.[citation needed]</summary>
public const string Host = "Host";
///<summary>Only perform the action if the client supplied entity matches the same entity on the server. This is mainly for methods like PUT to only update a resource if it has not been modified since the user last updated it.</summary>
public const string IfMatch = "If-Match";
///<summary>Allows a 304 Not Modified to be returned if content is unchanged</summary>
public const string IfModifiedSince = "If-Modified-Since";
///<summary>Allows a 304 Not Modified to be returned if content is unchanged, see HTTP ETag</summary>
public const string IfNoneMatch = "If-None-Match";
///<summary>If the entity is unchanged, send me the part(s) that I am missing; otherwise, send me the entire new entity</summary>
public const string IfRange = "If-Range";
///<summary>Only send the response if the entity has not been modified since a specific time.</summary>
public const string IfUnmodifiedSince = "If-Unmodified-Since";
///<summary>Limit the number of times the message can be forwarded through proxies or gateways.</summary>
public const string MaxForwards = "Max-Forwards";
///<summary>Implementation-specific headers that may have various effects anywhere along the request-response chain.</summary>
public const string Pragma = "Pragma";
///<summary>Authorization credentials for connecting to a proxy.</summary>
public const string ProxyAuthorization = "Proxy-Authorization";
///<summary>Request only part of an entity. Bytes are numbered from 0.</summary>
public const string Range = "Range";
///<summary>This is the address of the previous web page from which a link to the currently requested page was followed. (The word “referrer” is misspelled in the RFC as well as in most implementations.)</summary>
public const string Referersic = "Referer[sic]";
///<summary>The transfer encodings the user agent is willing to accept: the same values as for the response header Transfer-Encoding can be used, plus the trailers value (related to the chunked transfer method) to notify the server it expects to receive additional headers (the trailers) after the last, zero-sized, chunk.</summary>
public const string TE = "TE";
///<summary>Ask the server to upgrade to another protocol.</summary>
public const string Upgrade = "Upgrade";
///<summary>The user agent string of the user agent</summary>
public const string UserAgent = "User-Agent";
///<summary>Informs the server of proxies through which the request was sent.</summary>
public const string Via = "Via";
///<summary>A general warning about possible problems with the entity body.</summary>
public const string Warning = "Warning";
///<summary>Contains the original source address of the request.</summary>
public const string XForwardedFor = "X-Forwarded-For";
}

Response Headers

/// <summary>
/// Contains the standard set of headers applicable to an HTTP response.
/// </summary>
public static class HttpResponseHeaders
{
///<summary>What partial content range types this server supports</summary>
public const string AcceptRanges = "Accept-Ranges";
///<summary>The age the object has been in a proxy cache in seconds</summary>
public const string Age = "Age";
///<summary>Valid actions for a specified resource. To be used for a 405 Method not allowed</summary>
public const string Allow = "Allow";
///<summary>Tells all caching mechanisms from server to client whether they may cache this object. It is measured in seconds</summary>
public const string CacheControl = "Cache-Control";
///<summary>Options that are desired for the connection[17]</summary>
public const string Connection = "Connection";
///<summary>The type of encoding used on the data. See HTTP compression.</summary>
public const string ContentEncoding = "Content-Encoding";
///<summary>The language the content is in</summary>
public const string ContentLanguage = "Content-Language";
///<summary>The length of the response body in octets (8-bit bytes)</summary>
public const string ContentLength = "Content-Length";
///<summary>An alternate location for the returned data</summary>
public const string ContentLocation = "Content-Location";
///<summary>A Base64-encoded binary MD5 sum of the content of the response</summary>
public const string ContentMD5 = "Content-MD5";
///<summary>An opportunity to raise a File Download dialogue box for a known MIME type with binary format or suggest a filename for dynamic content. Quotes are necessary with special characters.</summary>
public const string ContentDisposition = "Content-Disposition";
///<summary>Where in a full body message this partial message belongs</summary>
public const string ContentRange = "Content-Range";
///<summary>The MIME type of this content</summary>
public const string ContentType = "Content-Type";
///<summary>The date and time that the message was sent</summary>
public const string Date = "Date";
///<summary>An identifier for a specific version of a resource, often a message digest</summary>
public const string ETag = "ETag";
///<summary>Gives the date/time after which the response is considered stale</summary>
public const string Expires = "Expires";
///<summary>The last modified date for the requested object, inRFC 2822 format</summary>
public const string LastModified = "Last-Modified";
///<summary>Used to express a typed relationship with another resource, where the relation type is defined by RFC 5988</summary>
public const string Link = "Link";
///<summary>Used in redirection, or when a new resource has been created.</summary>
public const string Location = "Location";
///<summary>This header is supposed to set P3P policy, in the form of P3P:CP=your_compact_policy. However, P3P did not take off,[22] most browsers have never fully implemented it, a lot of websites set this header with fake policy text, that was enough to fool browsers the existence of P3P policy and grant permissions for third party cookies.</summary>
public const string P3P = "P3P";
///<summary>Implementation-specific headers that may have various effects anywhere along the request-response chain.</summary>
public const string Pragma = "Pragma";
///<summary>Request authentication to access the proxy.</summary>
public const string ProxyAuthenticate = "Proxy-Authenticate";
///<summary>Used in redirection, or when a new resource has been created. This refresh redirects after 5 seconds. This is a proprietary, non-standard header extension introduced by Netscape and supported by most web browsers.</summary>
public const string Refresh = "Refresh";
///<summary>If an entity is temporarily unavailable, this instructs the client to try again after a specified period of time (seconds).</summary>
public const string RetryAfter = "Retry-After";
///<summary>A name for the server</summary>
public const string Server = "Server";
///<summary>an HTTP cookie</summary>
public const string SetCookie = "Set-Cookie";
///<summary>A HSTS Policy informing the HTTP client how long to cache the HTTPS only policy and whether this applies to subdomains.</summary>
public const string StrictTransportSecurity = "Strict-Transport-Security";
///<summary>The Trailer general field value indicates that the given set of header fields is present in the trailer of a message encoded with chunked transfer-coding.</summary>
public const string Trailer = "Trailer";
///<summary>The form of encoding used to safely transfer the entity to the user. Currently defined methods are:chunked, compress, deflate, gzip, identity.</summary>
public const string TransferEncoding = "Transfer-Encoding";
///<summary>Tells downstream proxies how to match future request headers to decide whether the cached response can be used rather than requesting a fresh one from the origin server.</summary>
public const string Vary = "Vary";
///<summary>Informs the client of proxies through which the response was sent.</summary>
public const string Via = "Via";
///<summary>A general warning about possible problems with the entity body.</summary>
public const string Warning = "Warning";
///<summary>Indicates the authentication scheme that should be used to access the requested entity.</summary>
public const string WWWAuthenticate = "WWW-Authenticate";
}

Microsoft created enums for the Request and Response Headers.

Take a look at the following:

HttpResponseHeader

HttpRequestHeader

To expand on Jed's answer.

The HttpResponseHeader and HttpRequestHeader enumerations can be used as your constants when using the WebHeaderCollection. WebHeaderCollection contains indexer properties that accept these enumerations.

You can use either a string or one of the enumerations to get and set the header value, and mix it up as well within you code.

Example LinqPad script:

var headers = new WebHeaderCollection();


headers["If-Modified-Since"] = "Sat, 29 Oct 1994 19:43:31 GMT";
// shows header name as "If-Modified-Since"
headers.Dump();
// shows expected header value of "Sat, 29 Oct 1994 19:43:31 GMT"
headers[HttpRequestHeader.IfModifiedSince].Dump();


headers.Clear();


headers[HttpRequestHeader.IfModifiedSince] = "Sat, 29 Oct 1994 19:43:31 GMT";
// shows header name as "If-Modified-Since"
headers.Dump();
// shows expected header value "Sat, 29 Oct 1994 19:43:31 GMT"
headers["If-Modified-Since"].Dump();

They have them in HttpKnownHeaderNames but unfortunately that class is internal. I opened an issue for it: https://github.com/dotnet/corefx/issues/10632.

I found this question while trying to discover the same thing: where are the header name constants as strings?

In ASP.NET Core, Microsoft.Net.Http.Headers.HeaderNames is the class that saved me.

public static class HeaderNames
{
public const string Accept = "Accept";
public const string AcceptCharset = "Accept-Charset";
public const string AcceptEncoding = "Accept-Encoding";
public const string AcceptLanguage = "Accept-Language";
public const string AcceptRanges = "Accept-Ranges";
public const string Age = "Age";
public const string Allow = "Allow";
public const string Authorization = "Authorization";
public const string CacheControl = "Cache-Control";
public const string Connection = "Connection";
public const string ContentDisposition = "Content-Disposition";
public const string ContentEncoding = "Content-Encoding";
public const string ContentLanguage = "Content-Language";
public const string ContentLength = "Content-Length";
public const string ContentLocation = "Content-Location";
public const string ContentMD5 = "Content-MD5";
public const string ContentRange = "Content-Range";
public const string ContentType = "Content-Type";
public const string Cookie = "Cookie";
public const string Date = "Date";
public const string ETag = "ETag";
public const string Expires = "Expires";
public const string Expect = "Expect";
public const string From = "From";
public const string Host = "Host";
public const string IfMatch = "If-Match";
public const string IfModifiedSince = "If-Modified-Since";
public const string IfNoneMatch = "If-None-Match";
public const string IfRange = "If-Range";
public const string IfUnmodifiedSince = "If-Unmodified-Since";
public const string LastModified = "Last-Modified";
public const string Location = "Location";
public const string MaxForwards = "Max-Forwards";
public const string Pragma = "Pragma";
public const string ProxyAuthenticate = "Proxy-Authenticate";
public const string ProxyAuthorization = "Proxy-Authorization";
public const string Range = "Range";
public const string Referer = "Referer";
public const string RetryAfter = "Retry-After";
public const string Server = "Server";
public const string SetCookie = "Set-Cookie";
public const string TE = "TE";
public const string Trailer = "Trailer";
public const string TransferEncoding = "Transfer-Encoding";
public const string Upgrade = "Upgrade";
public const string UserAgent = "User-Agent";
public const string Vary = "Vary";
public const string Via = "Via";
public const string Warning = "Warning";
public const string WebSocketSubProtocols = "Sec-WebSocket-Protocol";
public const string WWWAuthenticate = "WWW-Authenticate";
}
using System.Net.HttpRequestHeader;
using System.Net.HttpResponseHeader;


public class Example {
static void Main() {
Console.WriteLine(HttpRequestHeader.IfModifiedSince.ToHeaderString());
// If-Modified-Since


Console.WriteLine(HttpResponseHeader.ContentLength.ToHeaderString());
// Content-Length
}
}


static class ExtensionMethods {
public static string ToHeaderString(this HttpRequestHeader instance)
{
return Regex.Replace(instance.ToString(), "(\\B[A-Z])", "-$1");
}


public static string ToHeaderString(this HttpResponseHeader instance)
{
return Regex.Replace(instance.ToString(), "(\\B[A-Z])", "-$1");
}
}

There are some available in the Microsoft.Net.Http.Headers nuget package. In my asp.net core project it was already installed.

Example usage:

var value = request.Headers[Microsoft.Net.Http.Headers.HeaderNames.IfNoneMatch]

Might be what some are looking for?

If you're using .NET Framework (not .NET Core), you can create an extension method to properly format the System.Net.HttpRequestHeader enum:

using System;
using System.Net;
using System.Text;


namespace YourNamespace
{
public static class HttpRequestHeaderEx
{
public static string ToStandardName(this HttpRequestHeader requestHeader)
{
string headerName = requestHeader.ToString();


var headerStandardNameBuilder = new StringBuilder();
headerStandardNameBuilder.Append(headerName[0]);


for (int index = 1; index < headerName.Length; index++)
{
char character = headerName[index];
if (char.IsUpper(character))
{
headerStandardNameBuilder.Append('-');
}


headerStandardNameBuilder.Append(character);
}


string headerStandardName = headerStandardNameBuilder.ToString();


return headerStandardName;
}
}
}

Usage:

   var userAgentHeaderName = HttpRequestHeader.UserAgent.ToStandardName();

The Microsoft.Net.Http.Headers.HeaderNames class used to be the best, out-of-the-box option.

But since ASP.NET Core 3.0, the class has static read-only fields instead of constants. The reason is a performance optimization of comparisons:

  1. Reference comparison is faster than string contents ordinal case-insensitive comparison.
  2. Constants become a part of the consuming assembly while static fields do not. Thus references used to differ among the the uses of the constant in different assemblies, while after the change, they are all the same.

The downside of this optimization that the "constants" are not compile-time constants anymore and therefore are not usable e.g. with attributes ([FromHeader(Name = HeaderNames.IfNoneMatch)]).

Just create your own copy of the class in your code, using actual constants instead of the static fields.