HttpStatusCode HttpStatusCode HttpStatusCode HttpStatusCode Enum

Définition

Contient les valeurs des codes d'état définis pour HTTP.Contains the values of status codes defined for HTTP.

public enum class HttpStatusCode
public enum HttpStatusCode
type HttpStatusCode = 
Public Enum HttpStatusCode
Héritage
HttpStatusCodeHttpStatusCodeHttpStatusCodeHttpStatusCode

Champs

Accepted Accepted Accepted Accepted 202

Équivalent de l’état HTTP 202.Equivalent to HTTP status 202. Accepted Indique que la demande a été acceptée pour traitement ultérieur.Accepted indicates that the request has been accepted for further processing.

AlreadyReported AlreadyReported AlreadyReported AlreadyReported 208
Ambiguous Ambiguous Ambiguous Ambiguous 300

Équivalent de l’état HTTP 300.Equivalent to HTTP status 300. Ambiguous Indique que les informations demandées possèdent plusieurs représentations.Ambiguous indicates that the requested information has multiple representations. L’action par défaut consiste à traiter cet état comme une redirection et suivre le contenu de l’en-tête Location associé à cette réponse.The default action is to treat this status as a redirect and follow the contents of the Location header associated with this response. Ambigu est un synonyme de MultipleChoices.Ambiguous is a synonym for MultipleChoices.

BadGateway BadGateway BadGateway BadGateway 502

Équivalent de l’état HTTP 502.Equivalent to HTTP status 502. BadGateway Indique qu’un serveur proxy intermédiaire a reçu une réponse incorrecte à partir d’un autre proxy ou du serveur d’origine.BadGateway indicates that an intermediate proxy server received a bad response from another proxy or the origin server.

BadRequest BadRequest BadRequest BadRequest 400

Équivalent de l’état HTTP 400.Equivalent to HTTP status 400. BadRequest Indique que la demande ne peut pas comprise par le serveur.BadRequest indicates that the request could not be understood by the server. BadRequest est envoyé lorsque aucune autre erreur n’est applicable, ou si l’erreur exacte est inconnue ou n’a pas son propre code d’erreur.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

Équivalent de l’état HTTP 409.Equivalent to HTTP status 409. Conflict Indique que la demande ne peut pas être exécutée en raison d’un conflit sur le serveur.Conflict indicates that the request could not be carried out because of a conflict on the server.

Continue Continue Continue Continue 100

Équivalent de l’état HTTP 100.Equivalent to HTTP status 100. Continue Indique que le client peut poursuivre sa demande.Continue indicates that the client can continue with its request.

Created Created Created Created 201

Équivalent de l’état HTTP 201.Equivalent to HTTP status 201. Created Indique que la demande a provoqué la création d’une nouvelle ressource avant l’envoi de la réponse.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

Équivalent de l’état HTTP 417.Equivalent to HTTP status 417. ExpectationFailed Indique qu’une attente spécifiée dans un en-tête Expect ne peut pas être atteint par le serveur.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

Équivalent de l’état HTTP 403.Equivalent to HTTP status 403. Forbidden Indique que le serveur refuse de répondre à la demande.Forbidden indicates that the server refuses to fulfill the request.

Found Found Found Found 302

Équivalent de l’état HTTP 302.Equivalent to HTTP status 302. Found Indique que les informations demandées sont trouve à l’URI spécifié dans l’en-tête Location.Found indicates that the requested information is located at the URI specified in the Location header. L’action par défaut lors de la réception de cet état consiste à suivre l’en-tête Location associé à la réponse.The default action when this status is received is to follow the Location header associated with the response. Lorsque la méthode de demande d’origine est POST, la demande redirigée utilise la méthode GET.When the original request method was POST, the redirected request will use the GET method. Trouvé est un synonyme de rediriger.Found is a synonym for Redirect.

GatewayTimeout GatewayTimeout GatewayTimeout GatewayTimeout 504

Équivalent de l’état HTTP 504.Equivalent to HTTP status 504. GatewayTimeout Indique qu’un serveur proxy intermédiaire a expiré en attendant une réponse à partir d’un autre proxy ou du serveur d’origine.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

Équivalent de l’état HTTP 410.Equivalent to HTTP status 410. Gone Indique que la ressource demandée n’est plus disponible.Gone indicates that the requested resource is no longer available.

HttpVersionNotSupported HttpVersionNotSupported HttpVersionNotSupported HttpVersionNotSupported 505

Équivalent de l’état HTTP 505.Equivalent to HTTP status 505. HttpVersionNotSupported Indique que la version HTTP demandée n’est pas pris en charge par le serveur.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

Équivalent de l’état HTTP 500.Equivalent to HTTP status 500. InternalServerError Indique qu’une erreur générique s’est produite sur le serveur.InternalServerError indicates that a generic error has occurred on the server.

LengthRequired LengthRequired LengthRequired LengthRequired 411

Équivalent de l’état HTTP 411.Equivalent to HTTP status 411. LengthRequired Indique que l’en-tête Content-length requis est manquant.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

Équivalent de l’état HTTP 405.Equivalent to HTTP status 405. MethodNotAllowed Indique que la méthode de demande (POST ou GET) n’est pas autorisée sur la ressource demandée.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

Équivalent de l’état HTTP 301.Equivalent to HTTP status 301. Moved Indique que les informations demandées ont été déplacées vers l’URI spécifié dans l’en-tête Location.Moved indicates that the requested information has been moved to the URI specified in the Location header. L’action par défaut lors de la réception de cet état consiste à suivre l’en-tête Location associé à la réponse.The default action when this status is received is to follow the Location header associated with the response. Lorsque la méthode de demande d’origine est POST, la demande redirigée utilise la méthode GET.When the original request method was POST, the redirected request will use the GET method. Déplacé est un synonyme de MovedPermanently.Moved is a synonym for MovedPermanently.

MovedPermanently MovedPermanently MovedPermanently MovedPermanently 301

Équivalent de l’état HTTP 301.Equivalent to HTTP status 301. MovedPermanently Indique que les informations demandées ont été déplacées vers l’URI spécifié dans l’en-tête Location.MovedPermanently indicates that the requested information has been moved to the URI specified in the Location header. L’action par défaut lors de la réception de cet état consiste à suivre l’en-tête Location associé à la réponse.The default action when this status is received is to follow the Location header associated with the response. MovedPermanently est un synonyme de déplacé.MovedPermanently is a synonym for Moved.

MultipleChoices MultipleChoices MultipleChoices MultipleChoices 300

Équivalent de l’état HTTP 300.Equivalent to HTTP status 300. MultipleChoices Indique que les informations demandées possèdent plusieurs représentations.MultipleChoices indicates that the requested information has multiple representations. L’action par défaut consiste à traiter cet état comme une redirection et suivre le contenu de l’en-tête Location associé à cette réponse.The default action is to treat this status as a redirect and follow the contents of the Location header associated with this response. MultipleChoices est un synonyme de ambigu.MultipleChoices is a synonym for Ambiguous.

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

Équivalent de l’état HTTP 204.Equivalent to HTTP status 204. NoContent Indique que la demande a été correctement traitée et que la réponse vide est intentionnelle.NoContent indicates that the request has been successfully processed and that the response is intentionally blank.

NonAuthoritativeInformation NonAuthoritativeInformation NonAuthoritativeInformation NonAuthoritativeInformation 203

Équivalent de l’état HTTP 203.Equivalent to HTTP status 203. NonAuthoritativeInformation Indique que les méta-informations retournées à partir d’une copie mise en cache au lieu du serveur d’origine et par conséquent est peut-être incorrecte.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

Équivalent de l’état HTTP 406.Equivalent to HTTP status 406. NotAcceptable Indique que le client a spécifié, avec les en-têtes Accept, qu’il n’acceptera aucune des représentations disponibles de la ressource.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

Équivalent de l’état HTTP 404.Equivalent to HTTP status 404. NotFound Indique que la ressource demandée n’existe pas sur le serveur.NotFound indicates that the requested resource does not exist on the server.

NotImplemented NotImplemented NotImplemented NotImplemented 501

Équivalent de l’état HTTP 501.Equivalent to HTTP status 501. NotImplemented Indique que le serveur ne prend pas en charge la fonction demandée.NotImplemented indicates that the server does not support the requested function.

NotModified NotModified NotModified NotModified 304

Équivalent de l’état HTTP 304.Equivalent to HTTP status 304. NotModified Indique que la copie mise en cache du client est à jour.NotModified indicates that the client's cached copy is up to date. Le contenu de la ressource n’est pas transféré.The contents of the resource are not transferred.

OK OK OK OK 200

Équivalent de l’état HTTP 200.Equivalent to HTTP status 200. OK Indique que la demande a réussi et que les informations demandées figurent dans la réponse.OK indicates that the request succeeded and that the requested information is in the response. Voici le code d’état courant à recevoir.This is the most common status code to receive.

PartialContent PartialContent PartialContent PartialContent 206

Équivalent de l’état HTTP 206.Equivalent to HTTP status 206. PartialContent Indique que la réponse est une réponse partielle comme demandé par une requête GET qui inclut une plage d’octets.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

Équivalent de l’état HTTP 402.Equivalent to HTTP status 402. PaymentRequired est réservé pour une utilisation ultérieure.PaymentRequired is reserved for future use.

PermanentRedirect PermanentRedirect PermanentRedirect PermanentRedirect 308
PreconditionFailed PreconditionFailed PreconditionFailed PreconditionFailed 412

Équivalent de l’état HTTP 412.Equivalent to HTTP status 412. PreconditionFailed Indique qu’une condition définie pour cette demande a échoué, et la demande ne peut pas être effectuée. Conditions sont définies avec des en-têtes de demande conditionnels tels que If-Match, If-None-Match ou 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

Équivalent de l’état HTTP 407.Equivalent to HTTP status 407. ProxyAuthenticationRequired Indique que le proxy demandé requiert une authentification.ProxyAuthenticationRequired indicates that the requested proxy requires authentication. L’en-tête Proxy-authenticate contient les détails de l’exécution de l’authentification.The Proxy-authenticate header contains the details of how to perform the authentication.

Redirect Redirect Redirect Redirect 302

Équivalent de l’état HTTP 302.Equivalent to HTTP status 302. Redirect Indique que les informations demandées sont trouve à l’URI spécifié dans l’en-tête Location.Redirect indicates that the requested information is located at the URI specified in the Location header. L’action par défaut lors de la réception de cet état consiste à suivre l’en-tête Location associé à la réponse.The default action when this status is received is to follow the Location header associated with the response. Lorsque la méthode de demande d’origine est POST, la demande redirigée utilise la méthode GET.When the original request method was POST, the redirected request will use the GET method. Rediriger est un synonyme de trouvé.Redirect is a synonym for Found.

RedirectKeepVerb RedirectKeepVerb RedirectKeepVerb RedirectKeepVerb 307

Équivalent de l’état HTTP 307.Equivalent to HTTP status 307. RedirectKeepVerb Indique que les informations de demande sont situées à l’URI spécifié dans l’en-tête Location.RedirectKeepVerb indicates that the request information is located at the URI specified in the Location header. L’action par défaut lors de la réception de cet état consiste à suivre l’en-tête Location associé à la réponse.The default action when this status is received is to follow the Location header associated with the response. Lorsque la méthode de demande d’origine est POST, la demande redirigée utilisera également la méthode POST.When the original request method was POST, the redirected request will also use the POST method. RedirectKeepVerb est un synonyme de TemporaryRedirect.RedirectKeepVerb is a synonym for TemporaryRedirect.

RedirectMethod RedirectMethod RedirectMethod RedirectMethod 303

Équivalent de l’état HTTP 303.Equivalent to HTTP status 303. RedirectMethod redirige automatiquement le client vers l’URI spécifié dans l’en-tête Location suite à une publication.RedirectMethod automatically redirects the client to the URI specified in the Location header as the result of a POST. La demande à la ressource spécifiée par l’en-tête Location sera avec une opération GET.The request to the resource specified by the Location header will be made with a GET. RedirectMethod est un synonyme de SeeOther.RedirectMethod is a synonym for SeeOther.

RequestedRangeNotSatisfiable RequestedRangeNotSatisfiable RequestedRangeNotSatisfiable RequestedRangeNotSatisfiable 416

Équivalent de l’état HTTP 416.Equivalent to HTTP status 416. RequestedRangeNotSatisfiable Indique que la plage de données demandée à partir de la ressource ne peut pas être retournée, soit parce que le début de la plage est avant le début de la ressource ou la fin de la plage est après la fin de la ressource.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

Équivalent de l’état HTTP 413.Equivalent to HTTP status 413. RequestEntityTooLarge Indique que la demande est trop grande pour le serveur de traitement.RequestEntityTooLarge indicates that the request is too large for the server to process.

RequestHeaderFieldsTooLarge RequestHeaderFieldsTooLarge RequestHeaderFieldsTooLarge RequestHeaderFieldsTooLarge 431
RequestTimeout RequestTimeout RequestTimeout RequestTimeout 408

Équivalent de l’état HTTP 408.Equivalent to HTTP status 408. RequestTimeout Indique que le client n’a pas envoyé une demande dans le délai attendu par le serveur.RequestTimeout indicates that the client did not send a request within the time the server was expecting the request.

RequestUriTooLong RequestUriTooLong RequestUriTooLong RequestUriTooLong 414

Équivalent de l’état HTTP 414.Equivalent to HTTP status 414. RequestUriTooLong Indique que l’URI est trop long.RequestUriTooLong indicates that the URI is too long.

ResetContent ResetContent ResetContent ResetContent 205

Équivalent de l’état HTTP 205.Equivalent to HTTP status 205. ResetContent Indique que le client doit réinitialiser (et non recharger) la ressource actuelle.ResetContent indicates that the client should reset (not reload) the current resource.

SeeOther SeeOther SeeOther SeeOther 303

Équivalent de l’état HTTP 303.Equivalent to HTTP status 303. SeeOther redirige automatiquement le client vers l’URI spécifié dans l’en-tête Location suite à une publication.SeeOther automatically redirects the client to the URI specified in the Location header as the result of a POST. La demande à la ressource spécifiée par l’en-tête Location sera avec une opération GET.The request to the resource specified by the Location header will be made with a GET. SeeOther est un synonyme de RedirectMethodSeeOther is a synonym for RedirectMethod

ServiceUnavailable ServiceUnavailable ServiceUnavailable ServiceUnavailable 503

Équivalent de l’état HTTP 503.Equivalent to HTTP status 503. ServiceUnavailable Indique que le serveur est temporairement indisponible, généralement en raison d’une charge élevée ou de maintenance.ServiceUnavailable indicates that the server is temporarily unavailable, usually due to high load or maintenance.

SwitchingProtocols SwitchingProtocols SwitchingProtocols SwitchingProtocols 101

Équivalent de l’état HTTP 101.Equivalent to HTTP status 101. SwitchingProtocols Indique que la version du protocole ou le protocole est en cours de modification.SwitchingProtocols indicates that the protocol version or protocol is being changed.

TemporaryRedirect TemporaryRedirect TemporaryRedirect TemporaryRedirect 307

Équivalent de l’état HTTP 307.Equivalent to HTTP status 307. TemporaryRedirect Indique que les informations de demande sont situées à l’URI spécifié dans l’en-tête Location.TemporaryRedirect indicates that the request information is located at the URI specified in the Location header. L’action par défaut lors de la réception de cet état consiste à suivre l’en-tête Location associé à la réponse.The default action when this status is received is to follow the Location header associated with the response. Lorsque la méthode de demande d’origine est POST, la demande redirigée utilisera également la méthode POST.When the original request method was POST, the redirected request will also use the POST method. TemporaryRedirect est un synonyme de RedirectKeepVerb.TemporaryRedirect is a synonym for RedirectKeepVerb.

TooManyRequests TooManyRequests TooManyRequests TooManyRequests 429
Unauthorized Unauthorized Unauthorized Unauthorized 401

Équivalent de l’état HTTP 401.Equivalent to HTTP status 401. Unauthorized Indique que la ressource demandée requiert une authentification.Unauthorized indicates that the requested resource requires authentication. L’en-tête WWW-Authenticate contient les détails de l’exécution de l’authentification.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

Équivalent de l’état HTTP 415.Equivalent to HTTP status 415. UnsupportedMediaType Indique que la demande est un type non pris en charge.UnsupportedMediaType indicates that the request is an unsupported type.

Unused Unused Unused Unused 306

Équivalent de l’état HTTP 306.Equivalent to HTTP status 306. Unused est une proposition d’extension à la spécification HTTP/1.1 qui n’est pas entièrement spécifiée.Unused is a proposed extension to the HTTP/1.1 specification that is not fully specified.

UpgradeRequired UpgradeRequired UpgradeRequired UpgradeRequired 426

Équivalent de l’état HTTP 426.Equivalent to HTTP status 426. UpgradeRequired Indique que le client doit basculer vers un autre protocole tel que TLS/1.0.UpgradeRequired indicates that the client should switch to a different protocol such as TLS/1.0.

UseProxy UseProxy UseProxy UseProxy 305

Équivalent de l’état HTTP 305.Equivalent to HTTP status 305. UseProxy Indique que la demande doit utiliser le serveur proxy à l’URI spécifié dans l’en-tête Location.UseProxy indicates that the request should use the proxy server at the URI specified in the Location header.

VariantAlsoNegotiates VariantAlsoNegotiates VariantAlsoNegotiates VariantAlsoNegotiates 506

Exemples

L’exemple suivant compare l’état retourné par un HttpWebResponse avec un membre de la HttpStatusCode classe pour déterminer l’état d’une réponse.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()

Remarques

Le HttpStatusCode énumération contient les valeurs des codes d’état définis dans RFC 2616 pour HTTP 1.1.The HttpStatusCode enumeration contains the values of the status codes defined in RFC 2616 for HTTP 1.1.

L’état d’une requête HTTP est contenue dans le HttpWebResponse.StatusCode propriété.The status of an HTTP request is contained in the HttpWebResponse.StatusCode property.
Si le HttpWebRequest.AllowAutoRedirect propriété est false, les valeurs d’énumération suivantes provoquent une exception levée :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

S’applique à