Export (0) Print
Expand All

HttpStatusCode Enumeration

Contains the values of status codes defined for HTTP.

Namespace:  System.Net
Assemblies:   System (in System.dll)
  System.Net.Primitives (in System.Net.Primitives.dll)

public enum HttpStatusCode

Member nameDescription
Supported by Portable Class LibrarySupported in .NET for Windows Store appsAcceptedEquivalent to HTTP status 202. Accepted indicates that the request has been accepted for further processing.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsAmbiguousEquivalent to HTTP status 300. Ambiguous indicates that the requested information has multiple representations. The default action is to treat this status as a redirect and follow the contents of the Location header associated with this response.

If the HttpWebRequest.AllowAutoRedirect property is false, Ambiguous will cause an exception to be thrown.

Ambiguous is a synonym for MultipleChoices.

Supported by Portable Class LibrarySupported in .NET for Windows Store appsBadGatewayEquivalent to HTTP status 502. BadGateway indicates that an intermediate proxy server received a bad response from another proxy or the origin server.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsBadRequestEquivalent to HTTP status 400. BadRequest indicates that the request could not be understood by the server. BadRequest is sent when no other error is applicable, or if the exact error is unknown or does not have its own error code.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsConflictEquivalent to HTTP status 409. Conflict indicates that the request could not be carried out because of a conflict on the server.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsContinueEquivalent to HTTP status 100. Continue indicates that the client can continue with its request.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsCreatedEquivalent to HTTP status 201. Created indicates that the request resulted in a new resource created before the response was sent.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsExpectationFailedEquivalent to HTTP status 417. ExpectationFailed indicates that an expectation given in an Expect header could not be met by the server.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsForbiddenEquivalent to HTTP status 403. Forbidden indicates that the server refuses to fulfill the request.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsFoundEquivalent to HTTP status 302. Found indicates that the requested information is located at the URI specified in the Location header. The default action when this status is received is to follow the Location header associated with the response. When the original request method was POST, the redirected request will use the GET method.

If the HttpWebRequest.AllowAutoRedirect property is false, Found will cause an exception to be thrown.

Found is a synonym for Redirect.

Supported by Portable Class LibrarySupported in .NET for Windows Store appsGatewayTimeoutEquivalent to HTTP status 504. GatewayTimeout indicates that an intermediate proxy server timed out while waiting for a response from another proxy or the origin server.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsGoneEquivalent to HTTP status 410. Gone indicates that the requested resource is no longer available.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsHttpVersionNotSupportedEquivalent to HTTP status 505. HttpVersionNotSupported indicates that the requested HTTP version is not supported by the server.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsInternalServerErrorEquivalent to HTTP status 500. InternalServerError indicates that a generic error has occurred on the server.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsLengthRequiredEquivalent to HTTP status 411. LengthRequired indicates that the required Content-length header is missing.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsMethodNotAllowedEquivalent to HTTP status 405. MethodNotAllowed indicates that the request method (POST or GET) is not allowed on the requested resource.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsMovedEquivalent to HTTP status 301. Moved indicates that the requested information has been moved to the URI specified in the Location header. The default action when this status is received is to follow the Location header associated with the response. When the original request method was POST, the redirected request will use the GET method.

Moved is a synonym for MovedPermanently.

Supported by Portable Class LibrarySupported in .NET for Windows Store appsMovedPermanentlyEquivalent to HTTP status 301. MovedPermanently indicates that the requested information has been moved to the URI specified in the Location header. The default action when this status is received is to follow the Location header associated with the response.

MovedPermanently is a synonym for Moved.

Supported by Portable Class LibrarySupported in .NET for Windows Store appsMultipleChoicesEquivalent to HTTP status 300. MultipleChoices indicates that the requested information has multiple representations. The default action is to treat this status as a redirect and follow the contents of the Location header associated with this response.

If the HttpWebRequest.AllowAutoRedirect property is false, MultipleChoices will cause an exception to be thrown.

MultipleChoices is a synonym for Ambiguous.

Supported by Portable Class LibrarySupported in .NET for Windows Store appsNoContentEquivalent to HTTP status 204. NoContent indicates that the request has been successfully processed and that the response is intentionally blank.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsNonAuthoritativeInformationEquivalent to HTTP status 203. NonAuthoritativeInformation indicates that the returned metainformation is from a cached copy instead of the origin server and therefore may be incorrect.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsNotAcceptableEquivalent to HTTP status 406. NotAcceptable indicates that the client has indicated with Accept headers that it will not accept any of the available representations of the resource.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsNotFoundEquivalent to HTTP status 404. NotFound indicates that the requested resource does not exist on the server.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsNotImplementedEquivalent to HTTP status 501. NotImplemented indicates that the server does not support the requested function.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsNotModifiedEquivalent to HTTP status 304. NotModified indicates that the client's cached copy is up to date. The contents of the resource are not transferred.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsOKEquivalent to HTTP status 200. OK indicates that the request succeeded and that the requested information is in the response. This is the most common status code to receive.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsPartialContentEquivalent to HTTP status 206. PartialContent indicates that the response is a partial response as requested by a GET request that includes a byte range.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsPaymentRequiredEquivalent to HTTP status 402. PaymentRequired is reserved for future use.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsPreconditionFailedEquivalent to HTTP status 412. PreconditionFailed indicates that a condition set for this request failed, and the request cannot be carried out. Conditions are set with conditional request headers like If-Match, If-None-Match, or If-Unmodified-Since.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsProxyAuthenticationRequiredEquivalent to HTTP status 407. ProxyAuthenticationRequired indicates that the requested proxy requires authentication. The Proxy-authenticate header contains the details of how to perform the authentication.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsRedirectEquivalent to HTTP status 302. Redirect indicates that the requested information is located at the URI specified in the Location header. The default action when this status is received is to follow the Location header associated with the response. When the original request method was POST, the redirected request will use the GET method.

If the HttpWebRequest.AllowAutoRedirect property is false, Redirect will cause an exception to be thrown.

Redirect is a synonym for Found.

Supported by Portable Class LibrarySupported in .NET for Windows Store appsRedirectKeepVerbEquivalent to HTTP status 307. RedirectKeepVerb indicates that the request information is located at the URI specified in the Location header. The default action when this status is received is to follow the Location header associated with the response. When the original request method was POST, the redirected request will also use the POST method.

If the HttpWebRequest.AllowAutoRedirect property is false, RedirectKeepVerb will cause an exception to be thrown.

RedirectKeepVerb is a synonym for TemporaryRedirect.

Supported by Portable Class LibrarySupported in .NET for Windows Store appsRedirectMethodEquivalent to HTTP status 303. RedirectMethod automatically redirects the client to the URI specified in the Location header as the result of a POST. The request to the resource specified by the Location header will be made with a GET.

If the HttpWebRequest.AllowAutoRedirect property is false, RedirectMethod will cause an exception to be thrown.

RedirectMethod is a synonym for SeeOther.

Supported by Portable Class LibrarySupported in .NET for Windows Store appsRequestedRangeNotSatisfiableEquivalent to HTTP status 416. RequestedRangeNotSatisfiable indicates that the range of data requested from the resource cannot be returned, either because the beginning of the range is before the beginning of the resource, or the end of the range is after the end of the resource.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsRequestEntityTooLargeEquivalent to HTTP status 413. RequestEntityTooLarge indicates that the request is too large for the server to process.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsRequestTimeoutEquivalent to HTTP status 408. RequestTimeout indicates that the client did not send a request within the time the server was expecting the request.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsRequestUriTooLongEquivalent to HTTP status 414. RequestUriTooLong indicates that the URI is too long.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsResetContentEquivalent to HTTP status 205. ResetContent indicates that the client should reset (not reload) the current resource.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsSeeOtherEquivalent to HTTP status 303. SeeOther automatically redirects the client to the URI specified in the Location header as the result of a POST. The request to the resource specified by the Location header will be made with a GET.

If the HttpWebRequest.AllowAutoRedirect property is false, SeeOther will cause an exception to be thrown.

SeeOther is a synonym for RedirectMethod.

Supported by Portable Class LibrarySupported in .NET for Windows Store appsServiceUnavailableEquivalent to HTTP status 503. ServiceUnavailable indicates that the server is temporarily unavailable, usually due to high load or maintenance.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsSwitchingProtocolsEquivalent to HTTP status 101. SwitchingProtocols indicates that the protocol version or protocol is being changed.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsTemporaryRedirectEquivalent to HTTP status 307. TemporaryRedirect indicates that the request information is located at the URI specified in the Location header. The default action when this status is received is to follow the Location header associated with the response. When the original request method was POST, the redirected request will also use the POST method.

If the HttpWebRequest.AllowAutoRedirect property is false, TemporaryRedirect will cause an exception to be thrown.

TemporaryRedirect is a synonym for RedirectKeepVerb.

Supported by Portable Class LibrarySupported in .NET for Windows Store appsUnauthorizedEquivalent to HTTP status 401. Unauthorized indicates that the requested resource requires authentication. The WWW-Authenticate header contains the details of how to perform the authentication.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsUnsupportedMediaTypeEquivalent to HTTP status 415. UnsupportedMediaType indicates that the request is an unsupported type.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsUnusedEquivalent to HTTP status 306. Unused is a proposed extension to the HTTP/1.1 specification that is not fully specified.
Supported in .NET for Windows Store appsUpgradeRequiredEquivalent to HTTP status 426. UpgradeRequired indicates that the client should switch to a different protocol such as TLS/1.0.
Supported by Portable Class LibrarySupported in .NET for Windows Store appsUseProxyEquivalent to HTTP status 305. UseProxy indicates that the request should use the proxy server at the URI specified in the Location header.

The HttpStatusCode enumeration contains the values of the status codes defined in RFC 2616 for HTTP 1.1.

The status of an HTTP request is contained in the HttpWebResponse.StatusCode property.

The following example compares the status returned by an HttpWebResponse with a member of the HttpStatusCode class to determine the status of a response.

HttpWebRequest httpReq = (HttpWebRequest)WebRequest.Create("http://www.contoso.com");
httpReq.AllowAutoRedirect = false;

HttpWebResponse httpRes = (HttpWebResponse)httpReq.GetResponse();

if (httpRes.StatusCode==HttpStatusCode.Moved) 
{
   // Code for moved resources goes here.
}

// Close the response.
httpRes.Close();
  

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft