HttpStatusCode 列舉

定義

包含 HTTP 要求回應中為 HTTP 定義的狀態碼值。

public enum class HttpStatusCode
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class HttpStatusCode
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum HttpStatusCode
var value = Windows.Web.Http.HttpStatusCode.none
Public Enum HttpStatusCode
繼承
HttpStatusCode
屬性

Windows 需求

裝置系列
Windows 10 (已於 10.0.10240.0 引進)
API contract
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

欄位

Accepted 202

已接受要求以進行進一步處理。

AlreadyReported 208

已報告要求的作業部分結果。

此狀態碼是與 Web 分散式撰寫和版本設定搭配使用的 HTTP 擴充功能, (WebDAV) 。 只有在要求中包含 DAV 標頭的用戶端 HTTP 要求時,才能傳回它。 此狀態碼記載于 IETF RFC 5842中。

BadGateway 502

中繼 Proxy 伺服器收到來自另一個 Proxy 或源伺服器的不正確回應。

BadRequest 400

伺服器無法瞭解要求。 如果沒有其他錯誤適用,或確切的錯誤不明或沒有自己的錯誤碼,就會傳送此狀態碼。

Conflict 409

因為伺服器上的衝突,所以無法執行要求。

Continue 100

用戶端應該繼續其要求。

Created 201

要求會導致在傳送回應之前建立的新資源。

ExpectationFailed 417

伺服器無法符合 預期 標頭中指定的預期。

FailedDependency 424

無法對資源執行方法,因為所要求的動作相依于另一個動作,且該動作失敗。

此狀態碼是與 Web 分散式撰寫和版本設定搭配使用的 HTTP 擴充功能, (WebDAV) 。 此狀態碼記載于 IETF RFC 4918中。

Forbidden 403

伺服器拒絕履行要求。

Found 302

要求的資訊位於 Location 標頭中指定的 URI。 收到此狀態時的預設動作是遵循與回應相關聯的 位置 標頭。 當原始要求方法為 POST時,重新導向的要求會使用 GET 方法。

GatewayTimeout 504

在等候來自另一個 Proxy 或源伺服器的回應時,中繼 Proxy 伺服器逾時。

Gone 410

無法再使用所要求的資源。

HttpVersionNotSupported 505

伺服器不支援要求的 HTTP 版本。

IMUsed 226

伺服器已完成資源的 GET 要求,而回應是套用至目前實例的一或多個動作的結果。

此狀態碼記載于 IETF RFC 3229中。

InsufficientStorage 507

無法對資源執行 方法,因為伺服器無法儲存成功完成要求所需的標記法。 此條件會被視為暫時性。

此狀態碼是與 Web 分散式撰寫和版本設定搭配使用的 HTTP 擴充功能, (WebDAV) 。 此狀態碼記載于 IETF RFC 4918中。

InternalServerError 500

伺服器上已經發生泛用錯誤。

LengthRequired 411

遺漏必要的 Content-Length 標頭。

Locked 423

方法的來源或目的地資源已鎖定。 此回應應包含適當的前置條件或條件後程式碼。

此狀態碼是與 Web 分散式撰寫和版本設定搭配使用的 HTTP 擴充功能, (WebDAV) 。 此狀態碼記載于 IETF RFC 4918中。

LoopDetected 508

伺服器在處理要求時遇到無限迴圈而終止作業。 此狀態表示整個作業失敗。

此狀態碼是與 Web 分散式撰寫和版本設定搭配使用的 HTTP 擴充功能, (WebDAV) 。 只有在要求中包含 DAV 標頭的用戶端 HTTP 要求時,才能傳回它。 此狀態碼記載于 IETF RFC 5842中。

MethodNotAllowed 405

要求中的 HTTP 方法不允許在要求的資源上使用。

MovedPermanently 301

要求的資訊已移至 Location 標頭中指定的 URI。 收到此狀態時的預設動作是遵循與回應相關聯的 位置 標頭。

MultipleChoices 300

要求的資訊有多個標記法。 預設動作是將此狀態視為重新導向,並遵循與此回應相關聯的 位置 標頭內容。

MultiStatus 207

回應會提供多個獨立作業的狀態。 特定錯誤訊息會出現在多重狀態回應的本文中。

此狀態碼是與 Web 分散式撰寫和版本設定搭配使用的 HTTP 擴充功能, (WebDAV) 。 此狀態碼記載于 IETF RFC 4918中。

NetworkAuthenticationRequired 511

伺服器表示用戶端必須進行驗證,才能取得網路存取權。 回應應包含可讓使用者提交認證的資源連結。

此狀態碼記載于 IETF RFC 6585中。

NoContent 204

已成功處理要求,且回應刻意為空白。

NonAuthoritativeInformation 203

傳回的中繼資訊來自快取的複本,而不是源伺服器,因此可能不正確。

None 0

用戶端要求未成功。

NotAcceptable 406

用戶端已向 Accept 標頭指出,它不接受任何可用的資源標記法。

NotExtended 510

要求中尚未符合存取資源的原則。

此狀態碼記載于 IETF RFC 2774中。

NotFound 404

所要求的資源不存在於伺服器上。

NotImplemented 501

伺服器不支援要求的函式。

NotModified 304

用戶端的快取複本是最新的。 不傳輸資源的內容。

Ok 200

要求成功,且要求的資訊位於回應中。 這是要接收的最通用狀態碼。

PartialContent 206

回應是 GET 要求所要求的部分回應,其中包含位元組範圍。

PaymentRequired 402

此程式碼保留供日後使用。

PermanentRedirect 308

目標資源已獲指派新的永久 URI,而且未來任何對此資源的參考都應該使用 位置 標頭中指定的其中一個傳回 URI。

此狀態碼記載于 IETF 草稿草稿-reschke-HTTP-status-308中。

PreconditionFailed 412

針對此要求設定的條件失敗,而且無法執行要求。條件會設定為條件式要求標頭,例如 If-MatchIf-None-MatchIf-Unmodified-Since

PreconditionRequired 428

源伺服器需要有條件的要求。

此狀態碼記載于 IETF RFC 6585中。

Processing 102

伺服器已收到 Web Distributed Authoring and Versioning (WebDAV) 要求,並正在處理要求。

此狀態碼是與 WebDAV 搭配使用的 HTTP 擴充功能。 只有在要求中包含 DAV 標頭的用戶端 HTTP 要求時,才能傳回它。 此狀態碼記載于 IETF RFC 2518中。

ProxyAuthenticationRequired 407

要求的 Proxy 需要驗證。 Proxy-Authentication標頭包含如何執行驗證的詳細資料。

RequestedRangeNotSatisfiable 416

無法傳回從資源要求的資料範圍,可能是因為範圍的開頭是在資源的開頭之前,或範圍的結尾是在資源的結尾之後。

RequestEntityTooLarge 413

要求太大,伺服器無法處理。

RequestHeaderFieldsTooLarge 431

伺服器因為標頭欄位太大而無法處理要求。 在減少要求標頭欄位的大小之後,可能會重新提交要求。

此狀態碼記載于 IETF RFC 6585中。

RequestTimeout 408

用戶端未在伺服器預期要求的時間內傳送要求。

RequestUriTooLong 414

URI 太長。

ResetContent 205

用戶端應該重設 (不會重載目前資源) 。

SeeOther 303

自動將用戶端重新導向至 位置 標頭中指定的 URI,作為 POST的結果。 Location標頭所指定的資源要求將會使用GET方法進行。

ServiceUnavailable 503

伺服器暫時無法使用,通常是因為高負載或維護。

SwitchingProtocols 101

正在變更 HTTP 通訊協定版本或通訊協定。

TemporaryRedirect 307

要求資訊位於 位置 標頭中指定的 URI。 收到此狀態時的預設動作是遵循與回應相關聯的 Location 標頭。 原始要求方法為 POST時,重新導向的要求也會使用 POST 方法。

TooManyRequests 429

使用者已在特定時間內傳送太多要求。 回應應包含說明條件的詳細資料,而且可能包含 Retry-After 標頭,指出在提出新要求之前要等候多久。

此狀態碼記載于 IETF RFC 6585中。

Unauthorized 401

要求的資源需要驗證。 WWW-Authentication標頭包含如何執行驗證的詳細資料。

UnprocessableEntity 422

伺服器瞭解要求實體的內容類型,以及要求實體的語法正確,但伺服器無法處理包含的指令。

此狀態碼是用於 Web 分散式撰寫和版本設定的 HTTP 擴充功能, (WebDAV) 。 此狀態碼記載于 IETF RFC 4918中。

UnsupportedMediaType 415

要求是不支援的類型。

UpgradeRequired 426

用戶端應該切換至不同的通訊協定,例如 TLS/1.0。

此狀態碼記載于 IETF RFC 2917中。

UseProxy 305

要求應該在 Location 標頭中指定的 URI 上使用 Proxy 伺服器。

VariantAlsoNegotiates 506

伺服器發生內部設定錯誤。 所選的變體資源會設定為參與透明內容交涉本身,因此不是交涉程式中的適當端點。

此狀態碼記載于 IETF RFC 2295中。

備註

HttpStatusCode 列舉包含 RFC 2616 中 IETF 針對 HTTP 1.1 和相關 RFC 所定義的狀態碼值。

HTTP 要求的狀態包含在HttpResponseMessage物件的StatusCode屬性中。

適用於

另請參閱