HttpStatusCode HttpStatusCode HttpStatusCode HttpStatusCode Enum

Определение

Содержит значения кодов состояний, определенных для протокола HTTP.Contains the values of status codes defined for HTTP.

public enum class HttpStatusCode
public enum HttpStatusCode
type HttpStatusCode = 
Public Enum HttpStatusCode
Наследование
HttpStatusCodeHttpStatusCodeHttpStatusCodeHttpStatusCode

Поля

Accepted Accepted Accepted Accepted 202

Эквивалент HTTP-состояния 202.Equivalent to HTTP status 202. Accepted Указывает, что запрос принят для дальнейшей обработки.Accepted indicates that the request has been accepted for further processing.

AlreadyReported AlreadyReported AlreadyReported AlreadyReported 208
Ambiguous Ambiguous Ambiguous Ambiguous 300

Эквивалент HTTP-состояния 300.Equivalent to HTTP status 300. Ambiguous Указывает, что запрашиваемые данные имеют несколько представлений.Ambiguous indicates that the requested information has multiple representations. Действие по умолчанию — рассматривают это состояние в перенаправлении и отслеживании данных заголовка Location, связанного с этим ответом.The default action is to treat this status as a redirect and follow the contents of the Location header associated with this response. Неоднозначные является синонимом MultipleChoices.Ambiguous is a synonym for MultipleChoices.

BadGateway BadGateway BadGateway BadGateway 502

Эквивалент HTTP-состояния 502.Equivalent to HTTP status 502. BadGateway Указывает, что промежуточный прокси-сервер получил неправильный ответ от другого прокси или исходного сервера.BadGateway indicates that an intermediate proxy server received a bad response from another proxy or the origin server.

BadRequest BadRequest BadRequest BadRequest 400

Эквивалент HTTP-состояния 400.Equivalent to HTTP status 400. BadRequest Указывает, что запрос не удалось распознать сервером.BadRequest indicates that the request could not be understood by the server. BadRequest отправляется при других ошибок не применим, или если конкретная ошибка неизвестна или не имеет собственного кода ошибки.BadRequest is sent when no other error is applicable, or if the exact error is unknown or does not have its own error code.

Conflict Conflict Conflict Conflict 409

Эквивалент HTTP-состояния 409.Equivalent to HTTP status 409. Conflict Указывает, что запрос может не выполняться из-за конфликта на сервере.Conflict indicates that the request could not be carried out because of a conflict on the server.

Continue Continue Continue Continue 100

Эквивалент HTTP-состояния 100.Equivalent to HTTP status 100. Continue Указывает, что клиент может продолжать выполнять свой запрос.Continue indicates that the client can continue with its request.

Created Created Created Created 201

Эквивалент HTTP-состояния 201.Equivalent to HTTP status 201. Created Указывает, что запрос привел к созданию нового ресурса перед отправкой ответа.Created indicates that the request resulted in a new resource created before the response was sent.

EarlyHints EarlyHints EarlyHints EarlyHints 103
ExpectationFailed ExpectationFailed ExpectationFailed ExpectationFailed 417

Эквивалент HTTP-состояния 417.Equivalent to HTTP status 417. ExpectationFailed Указывает, что ожидание, заданное в заголовке Expect, не может быть выполнено сервером.ExpectationFailed indicates that an expectation given in an Expect header could not be met by the server.

FailedDependency FailedDependency FailedDependency FailedDependency 424
Forbidden Forbidden Forbidden Forbidden 403

Эквивалент HTTP-состояния 403.Equivalent to HTTP status 403. Forbidden Указывает, что сервер отказывается выполнять запрос.Forbidden indicates that the server refuses to fulfill the request.

Found Found Found Found 302

Эквивалент HTTP-состояния 302.Equivalent to HTTP status 302. Found Указывает, что запрашиваемые данные расположены по URI, указанный в заголовке Location.Found indicates that the requested information is located at the URI specified in the Location header. Действие по умолчанию, при получении этого состояния — отслеживании заголовка Location, связанного с ответом.The default action when this status is received is to follow the Location header associated with the response. Когда исходного запроса использовался метод POST, перенаправляемый запрос будет использовать метод GET.When the original request method was POST, the redirected request will use the GET method. Найти является синонимом перенаправления.Found is a synonym for Redirect.

GatewayTimeout GatewayTimeout GatewayTimeout GatewayTimeout 504

Эквивалент HTTP-состояния 504.Equivalent to HTTP status 504. GatewayTimeout Указывает, что промежуточный прокси-сервер истекло при ожидании ответа от другого прокси-сервера или сервера-источника.GatewayTimeout indicates that an intermediate proxy server timed out while waiting for a response from another proxy or the origin server.

Gone Gone Gone Gone 410

Эквивалент HTTP-состояния 410.Equivalent to HTTP status 410. Gone Указывает, что запрошенный ресурс больше не доступен.Gone indicates that the requested resource is no longer available.

HttpVersionNotSupported HttpVersionNotSupported HttpVersionNotSupported HttpVersionNotSupported 505

Эквивалент HTTP-состояния 505.Equivalent to HTTP status 505. HttpVersionNotSupported Указывает, что запрашиваемая версия HTTP не поддерживается сервером.HttpVersionNotSupported indicates that the requested HTTP version is not supported by the server.

IMUsed IMUsed IMUsed IMUsed 226
InsufficientStorage InsufficientStorage InsufficientStorage InsufficientStorage 507
InternalServerError InternalServerError InternalServerError InternalServerError 500

Эквивалент HTTP-состояния 500.Equivalent to HTTP status 500. InternalServerError Указывает, что на сервере произошла общая ошибка.InternalServerError indicates that a generic error has occurred on the server.

LengthRequired LengthRequired LengthRequired LengthRequired 411

Эквивалент HTTP-состояния 411.Equivalent to HTTP status 411. LengthRequired Указывает, что требуемый заголовок Content-length отсутствует.LengthRequired indicates that the required Content-length header is missing.

Locked Locked Locked Locked 423
LoopDetected LoopDetected LoopDetected LoopDetected 508
MethodNotAllowed MethodNotAllowed MethodNotAllowed MethodNotAllowed 405

Эквивалент HTTP-состояния 405.Equivalent to HTTP status 405. MethodNotAllowed Указывает, что метод запроса (POST или GET) не разрешено для запрашиваемого ресурса.MethodNotAllowed indicates that the request method (POST or GET) is not allowed on the requested resource.

MisdirectedRequest MisdirectedRequest MisdirectedRequest MisdirectedRequest 421
Moved Moved Moved Moved 301

Эквивалент HTTP-состояния 301.Equivalent to HTTP status 301. Moved Указывает, что запрашиваемые данные было перемещено в URI, указанный в заголовке Location.Moved indicates that the requested information has been moved to the URI specified in the Location header. Действие по умолчанию, при получении этого состояния — отслеживании заголовка Location, связанного с ответом.The default action when this status is received is to follow the Location header associated with the response. Когда исходного запроса использовался метод POST, перенаправляемый запрос будет использовать метод GET.When the original request method was POST, the redirected request will use the GET method. Переместить является синонимом MovedPermanently.Moved is a synonym for MovedPermanently.

MovedPermanently MovedPermanently MovedPermanently MovedPermanently 301

Эквивалент HTTP-состояния 301.Equivalent to HTTP status 301. MovedPermanently Указывает, что запрашиваемые данные было перемещено в URI, указанный в заголовке Location.MovedPermanently indicates that the requested information has been moved to the URI specified in the Location header. Действие по умолчанию, при получении этого состояния — отслеживании заголовка Location, связанного с ответом.The default action when this status is received is to follow the Location header associated with the response. MovedPermanently является синонимом перемещено.MovedPermanently is a synonym for Moved.

MultipleChoices MultipleChoices MultipleChoices MultipleChoices 300

Эквивалент HTTP-состояния 300.Equivalent to HTTP status 300. MultipleChoices Указывает, что запрашиваемые данные имеют несколько представлений.MultipleChoices indicates that the requested information has multiple representations. Действие по умолчанию — рассматривают это состояние в перенаправлении и отслеживании данных заголовка Location, связанного с этим ответом.The default action is to treat this status as a redirect and follow the contents of the Location header associated with this response. MultipleChoices является синонимом неоднозначный.MultipleChoices is a synonym for Ambiguous.

MultiStatus MultiStatus MultiStatus MultiStatus 207
NetworkAuthenticationRequired NetworkAuthenticationRequired NetworkAuthenticationRequired NetworkAuthenticationRequired 511
NoContent NoContent NoContent NoContent 204

Эквивалент HTTP-состояния 204.Equivalent to HTTP status 204. NoContent Указывает, что запрос успешно обработан и ответ является преднамеренно пустым.NoContent indicates that the request has been successfully processed and that the response is intentionally blank.

NonAuthoritativeInformation NonAuthoritativeInformation NonAuthoritativeInformation NonAuthoritativeInformation 203

Эквивалент HTTP-состояния 203.Equivalent to HTTP status 203. NonAuthoritativeInformation Указывает, что возвращенные метаданные взяты из кэшированной копии вместо исходного сервера и поэтому могут быть неверными.NonAuthoritativeInformation indicates that the returned metainformation is from a cached copy instead of the origin server and therefore may be incorrect.

NotAcceptable NotAcceptable NotAcceptable NotAcceptable 406

Эквивалент HTTP-состояния 406.Equivalent to HTTP status 406. NotAcceptable Указывает, что клиент показывает с помощью заголовков Accept, он не принимает любые из доступных представлений ресурса.NotAcceptable indicates that the client has indicated with Accept headers that it will not accept any of the available representations of the resource.

NotExtended NotExtended NotExtended NotExtended 510
NotFound NotFound NotFound NotFound 404

Эквивалент HTTP-состояния 404.Equivalent to HTTP status 404. NotFound Указывает, что запрошенный ресурс не существует на сервере.NotFound indicates that the requested resource does not exist on the server.

NotImplemented NotImplemented NotImplemented NotImplemented 501

Эквивалент HTTP-состояния 501.Equivalent to HTTP status 501. NotImplemented Указывает, что сервер не поддерживает запрашиваемую функцию.NotImplemented indicates that the server does not support the requested function.

NotModified NotModified NotModified NotModified 304

Эквивалент HTTP-состояния 304.Equivalent to HTTP status 304. NotModified Указывает, что клиентская кэшированная копия не требуется.NotModified indicates that the client's cached copy is up to date. Содержимое ресурса, не переносятся.The contents of the resource are not transferred.

OK OK OK OK 200

Эквивалент HTTP-состояния 200.Equivalent to HTTP status 200. OK Указывает, что запрос выполнен успешно и запрашиваемые данные в ответе.OK indicates that the request succeeded and that the requested information is in the response. Это наиболее распространенных получаемый код состояния.This is the most common status code to receive.

PartialContent PartialContent PartialContent PartialContent 206

Эквивалент HTTP-состояния 206.Equivalent to HTTP status 206. PartialContent Указывает, что ответ является частичным ответом по запрос GET, содержащий диапазон байтов.PartialContent indicates that the response is a partial response as requested by a GET request that includes a byte range.

PaymentRequired PaymentRequired PaymentRequired PaymentRequired 402

Эквивалент HTTP-состояния 402.Equivalent to HTTP status 402. PaymentRequired Зарезервировано для использования в будущем.PaymentRequired is reserved for future use.

PermanentRedirect PermanentRedirect PermanentRedirect PermanentRedirect 308
PreconditionFailed PreconditionFailed PreconditionFailed PreconditionFailed 412

Эквивалент HTTP-состояния 412.Equivalent to HTTP status 412. PreconditionFailed Указывает, что условие, установленное для этого запроса не удалось, и запрос не может быть выполнена. Условия задаются с помощью заголовков условного запроса, таких как If-Match, If-None-Match или If-Unmodified-Since.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.

PreconditionRequired PreconditionRequired PreconditionRequired PreconditionRequired 428
Processing Processing Processing Processing 102
ProxyAuthenticationRequired ProxyAuthenticationRequired ProxyAuthenticationRequired ProxyAuthenticationRequired 407

Эквивалент HTTP-состояния 407.Equivalent to HTTP status 407. ProxyAuthenticationRequired Указывает, что запрашиваемый прокси требует проверки подлинности.ProxyAuthenticationRequired indicates that the requested proxy requires authentication. Заголовок Proxy-authenticate содержит сведения о том, как выполнить проверку подлинности.The Proxy-authenticate header contains the details of how to perform the authentication.

Redirect Redirect Redirect Redirect 302

Эквивалент HTTP-состояния 302.Equivalent to HTTP status 302. Redirect Указывает, что запрашиваемые данные расположены по URI, указанный в заголовке Location.Redirect indicates that the requested information is located at the URI specified in the Location header. Действие по умолчанию, при получении этого состояния — отслеживании заголовка Location, связанного с ответом.The default action when this status is received is to follow the Location header associated with the response. Когда исходного запроса использовался метод POST, перенаправляемый запрос будет использовать метод GET.When the original request method was POST, the redirected request will use the GET method. Перенаправления является синонимом обнаружен.Redirect is a synonym for Found.

RedirectKeepVerb RedirectKeepVerb RedirectKeepVerb RedirectKeepVerb 307

Эквивалент HTTP-состояния 307.Equivalent to HTTP status 307. RedirectKeepVerb Указывает, что данные запроса расположены по URI, указанный в заголовке Location.RedirectKeepVerb indicates that the request information is located at the URI specified in the Location header. Действие по умолчанию, при получении этого состояния — отслеживании заголовка Location, связанного с ответом.The default action when this status is received is to follow the Location header associated with the response. Когда исходного запроса использовался метод POST, перенаправляемый запрос будет также использовать метод POST.When the original request method was POST, the redirected request will also use the POST method. RedirectKeepVerb является синонимом TemporaryRedirect.RedirectKeepVerb is a synonym for TemporaryRedirect.

RedirectMethod RedirectMethod RedirectMethod RedirectMethod 303

Эквивалент HTTP-состояния 303.Equivalent to HTTP status 303. RedirectMethod автоматически перенаправляет клиента к URI, указанный в заголовке Location, в результате сообщение.RedirectMethod automatically redirects the client to the URI specified in the Location header as the result of a POST. Запрос ресурса, задаваемого заголовком Location, выполняется с помощью метода GET.The request to the resource specified by the Location header will be made with a GET. RedirectMethod является синонимом SeeOther.RedirectMethod is a synonym for SeeOther.

RequestedRangeNotSatisfiable RequestedRangeNotSatisfiable RequestedRangeNotSatisfiable RequestedRangeNotSatisfiable 416

Эквивалент HTTP-состояния 416.Equivalent to HTTP status 416. RequestedRangeNotSatisfiable Указывает, что диапазон запрошенных у ресурса данных не может быть возвращен из-за начало диапазона — до начала ресурса или конца диапазона после конца ресурса.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.

RequestEntityTooLarge RequestEntityTooLarge RequestEntityTooLarge RequestEntityTooLarge 413

Эквивалент HTTP-состояния 413.Equivalent to HTTP status 413. RequestEntityTooLarge Указывает, что запрос слишком велик для обработки.RequestEntityTooLarge indicates that the request is too large for the server to process.

RequestHeaderFieldsTooLarge RequestHeaderFieldsTooLarge RequestHeaderFieldsTooLarge RequestHeaderFieldsTooLarge 431
RequestTimeout RequestTimeout RequestTimeout RequestTimeout 408

Эквивалент HTTP-состояния 408.Equivalent to HTTP status 408. RequestTimeout Указывает, что клиент не послал запрос в течение времени, запрос ожидался сервером.RequestTimeout indicates that the client did not send a request within the time the server was expecting the request.

RequestUriTooLong RequestUriTooLong RequestUriTooLong RequestUriTooLong 414

Эквивалент HTTP-состояния 414.Equivalent to HTTP status 414. RequestUriTooLong Указывает, что URI слишком длинное.RequestUriTooLong indicates that the URI is too long.

ResetContent ResetContent ResetContent ResetContent 205

Эквивалент HTTP-состояния 205.Equivalent to HTTP status 205. ResetContent Указывает, что клиент должен сбросить (не перезагрузить) текущий ресурс.ResetContent indicates that the client should reset (not reload) the current resource.

SeeOther SeeOther SeeOther SeeOther 303

Эквивалент HTTP-состояния 303.Equivalent to HTTP status 303. SeeOther автоматически перенаправляет клиента к URI, указанный в заголовке Location, в результате сообщение.SeeOther automatically redirects the client to the URI specified in the Location header as the result of a POST. Запрос ресурса, задаваемого заголовком Location, выполняется с помощью метода GET.The request to the resource specified by the Location header will be made with a GET. SeeOther является синонимом RedirectMethodSeeOther is a synonym for RedirectMethod

ServiceUnavailable ServiceUnavailable ServiceUnavailable ServiceUnavailable 503

Эквивалент HTTP-состояния 503.Equivalent to HTTP status 503. ServiceUnavailable Указывает, что сервер временно недоступен, обычно из-за высокой нагрузки или обслуживания.ServiceUnavailable indicates that the server is temporarily unavailable, usually due to high load or maintenance.

SwitchingProtocols SwitchingProtocols SwitchingProtocols SwitchingProtocols 101

Эквивалент HTTP-состояния 101.Equivalent to HTTP status 101. SwitchingProtocols Указывает, что изменяется протокол или версия протокола.SwitchingProtocols indicates that the protocol version or protocol is being changed.

TemporaryRedirect TemporaryRedirect TemporaryRedirect TemporaryRedirect 307

Эквивалент HTTP-состояния 307.Equivalent to HTTP status 307. TemporaryRedirect Указывает, что данные запроса расположены по URI, указанный в заголовке Location.TemporaryRedirect indicates that the request information is located at the URI specified in the Location header. Действие по умолчанию, при получении этого состояния — отслеживании заголовка Location, связанного с ответом.The default action when this status is received is to follow the Location header associated with the response. Когда исходного запроса использовался метод POST, перенаправляемый запрос будет также использовать метод POST.When the original request method was POST, the redirected request will also use the POST method. TemporaryRedirect является синонимом RedirectKeepVerb.TemporaryRedirect is a synonym for RedirectKeepVerb.

TooManyRequests TooManyRequests TooManyRequests TooManyRequests 429
Unauthorized Unauthorized Unauthorized Unauthorized 401

Эквивалент HTTP-состояния 401.Equivalent to HTTP status 401. Unauthorized Указывает, что запрошенный ресурс требует проверки подлинности.Unauthorized indicates that the requested resource requires authentication. Заголовок WWW-Authenticate подробно излагается порядок выполнения проверки подлинности.The WWW-Authenticate header contains the details of how to perform the authentication.

UnavailableForLegalReasons UnavailableForLegalReasons UnavailableForLegalReasons UnavailableForLegalReasons 451
UnprocessableEntity UnprocessableEntity UnprocessableEntity UnprocessableEntity 422
UnsupportedMediaType UnsupportedMediaType UnsupportedMediaType UnsupportedMediaType 415

Эквивалент HTTP-состояния 415.Equivalent to HTTP status 415. UnsupportedMediaType Указывает, что запрос является неподдерживаемым типом.UnsupportedMediaType indicates that the request is an unsupported type.

Unused Unused Unused Unused 306

Эквивалент HTTP-состояния 306.Equivalent to HTTP status 306. Unused является предлагаемым расширением спецификации HTTP/1.1, которое указано не полностью.Unused is a proposed extension to the HTTP/1.1 specification that is not fully specified.

UpgradeRequired UpgradeRequired UpgradeRequired UpgradeRequired 426

Эквивалент HTTP-состояния 426.Equivalent to HTTP status 426. UpgradeRequired Указывает, что клиент должен переключиться на другой протокол, например TLS/1.0.UpgradeRequired indicates that the client should switch to a different protocol such as TLS/1.0.

UseProxy UseProxy UseProxy UseProxy 305

Эквивалент HTTP-состояния 305.Equivalent to HTTP status 305. UseProxy Указывает, что запрос должен использовать прокси-сервера в URI, указанный в заголовке Location.UseProxy indicates that the request should use the proxy server at the URI specified in the Location header.

VariantAlsoNegotiates VariantAlsoNegotiates VariantAlsoNegotiates VariantAlsoNegotiates 506

Примеры

В следующем примере сравнивается состояние, возвращаемое HttpWebResponse с членом HttpStatusCode класс, чтобы определить состояние ответа.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 = dynamic_cast<HttpWebRequest^>(WebRequest::Create( "http://www.contoso.com" ));
httpReq->AllowAutoRedirect = false;
HttpWebResponse^ httpRes = dynamic_cast<HttpWebResponse^>(httpReq->GetResponse());
if ( httpRes->StatusCode == HttpStatusCode::Moved )
{
   // Code for moved resources goes here.
}

// Close the response.
httpRes->Close();
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();
Dim httpReq As HttpWebRequest = CType(WebRequest.Create("http://www.contoso.com"), HttpWebRequest)
httpReq.AllowAutoRedirect = False
       
Dim httpRes As HttpWebResponse = CType(httpReq.GetResponse(), HttpWebResponse)
       
If httpRes.StatusCode = HttpStatusCode.Moved Then
    ' Code for moved resources goes here.
End If

httpRes.Close()

Комментарии

HttpStatusCode Перечисление содержит значения кодов состояния, определенный в RFC 2616 для HTTP 1.1.The HttpStatusCode enumeration contains the values of the status codes defined in RFC 2616 for HTTP 1.1.

Состояние HTTP-запрос, содержащийся в HttpWebResponse.StatusCode свойство.The status of an HTTP request is contained in the HttpWebResponse.StatusCode property.
Если HttpWebRequest.AllowAutoRedirect свойство false, следующие значения перечисления вызвать исключение, исключение:If the HttpWebRequest.AllowAutoRedirect property is false, the following enumeration values cause an exception to be thrown:

  • Ambiguous
  • Found
  • MultipleChoices
  • Redirect
  • RedirectKeepVerb
  • RedirectMethod
  • SeeOther
  • TemporaryRedirect

Применяется к