HttpStatusCode 列舉
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
包含 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-Match、 If-None-Match或 If-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屬性中。