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 分布式创作和版本控制 (WebDAV) 的 HTTP 扩展。 仅当客户端 HTTP 请求在请求中包含 DAV 标头时,才能返回该标头。 IETF RFC 5842 中记录了此状态代码。

BadGateway 502

中间代理服务器收到来自另一个代理或源服务器的错误响应。

BadRequest 400

服务器无法理解请求。 如果没有其他适用的错误,或者确切的错误未知或没有自己的错误代码,则发送此状态代码。

Conflict 409

由于服务器上的冲突,无法执行请求。

Continue 100

客户端应继续执行其请求。

Created 201

请求导致在发送响应之前创建新资源。

ExpectationFailed 417

服务器无法满足 Expect 标头中给定的期望。

FailedDependency 424

无法对资源执行 方法,因为请求的操作依赖于另一个操作,并且该操作失败。

此状态代码是用于 Web 分布式创作和版本控制 (WebDAV) 的 HTTP 扩展。 IETF RFC 4918 中记录了此状态代码。

Forbidden 403

服务器拒绝满足请求。

Found 302

请求的信息位于 Location 标头中指定的 URI 处。 收到此状态时的默认操作是遵循与响应关联的 Location 标头。 当原始请求方法是 POST 时,重定向的请求将使用 GET 方法。

GatewayTimeout 504

中间代理服务器在等待另一个代理或源服务器的响应时超时。

Gone 410

请求的资源不再可用。

HttpVersionNotSupported 505

服务器不支持请求的 HTTP 版本。

IMUsed 226

服务器已完成对资源的 GET 请求,响应是应用于当前实例的一个或多个操作的结果。

IETF RFC 3229 中记录了此状态代码。

InsufficientStorage 507

无法对资源执行 方法,因为服务器无法存储成功完成请求所需的表示形式。 此情况被视为暂时性。

此状态代码是用于 Web 分布式创作和版本控制 (WebDAV) 的 HTTP 扩展。 IETF RFC 4918 中记录了此状态代码。

InternalServerError 500

服务器上发生了一般错误。

LengthRequired 411

缺少所需的 Content-Length 标头。

Locked 423

方法的源或目标资源已锁定。 此响应应包含适当的前提条件或后条件代码。

此状态代码是用于 Web 分布式创作和版本控制 (WebDAV) 的 HTTP 扩展。 IETF RFC 4918 中记录了此状态代码。

LoopDetected 508

服务器终止了操作,因为它在处理请求时遇到无限循环。 此状态指示整个操作失败。

此状态代码是用于 Web 分布式创作和版本控制 (WebDAV) 的 HTTP 扩展。 仅当客户端 HTTP 请求在请求中包含 DAV 标头时,才能返回该标头。 IETF RFC 5842 中记录了此状态代码。

MethodNotAllowed 405

请求中的 HTTP 方法在请求的资源上是不允许的。

MovedPermanently 301

请求的信息已移动到 Location 标头中指定的 URI。 收到此状态时的默认操作是遵循与响应关联的 Location 标头。

MultipleChoices 300

请求的信息具有多个表示形式。 默认操作是将此状态视为重定向,并遵循与此响应关联的 Location 标头的内容。

MultiStatus 207

响应为多个独立操作提供状态。 特定错误消息显示在多状态响应的正文中。

此状态代码是用于 Web 分布式创作和版本控制 (WebDAV) 的 HTTP 扩展。 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,将来对此资源的任何引用都应使用 Location 标头中指定的返回 URI 之一。

此状态代码记录在 IETF 草稿 draft-reschke-http-status-308 中。

PreconditionFailed 412

为此请求设置的条件失败,并且无法执行该请求。条件是使用条件请求标头(如 If-MatchIf-None-MatchIf-Unmodified-Since)设置的。

PreconditionRequired 428

源服务器要求请求是有条件的。

IETF RFC 6585 中记录了此状态代码。

Processing 102

服务器已收到 Web 分布式创作和版本控制 (WebDAV) 请求,并正在处理请求。

此状态代码是用于 WebDAV 的 HTTP 扩展。 仅当客户端 HTTP 请求在请求中包含 DAV 标头时,才能返回该标头。 IETF RFC 2518 中记录了此状态代码。

ProxyAuthenticationRequired 407

请求的代理需要身份验证。 Proxy-Authenticate 标头包含如何执行身份验证的详细信息。

RequestedRangeNotSatisfiable 416

无法返回从资源请求的数据范围,因为范围的开头在资源的开头之前,或者范围结束在资源末尾之后。

RequestEntityTooLarge 413

请求太大,服务器无法处理。

RequestHeaderFieldsTooLarge 431

服务器不愿意处理请求,因为它的标头字段太大。 减小请求标头字段的大小后,可能会重新提交请求。

IETF RFC 6585 中记录了此状态代码。

RequestTimeout 408

客户端未在服务器预期请求的时间内发送请求。

RequestUriTooLong 414

URI 太长。

ResetContent 205

客户端应重置 (不重新加载) 当前资源。

SeeOther 303

自动将客户端重定向到 POST 结果在 Location 标头中指定的 URI。 将使用 GET 方法对 Location 标头指定的资源发出请求。

ServiceUnavailable 503

服务器暂时不可用,通常是由于高负载或维护。

SwitchingProtocols 101

正在更改 HTTP 协议版本或协议。

TemporaryRedirect 307

请求信息位于 Location 标头中指定的 URI 处。 收到此状态时的默认操作是遵循与响应关联的 Location 标头。 当原始请求方法是 POST 时,重定向的请求也将使用 POST 方法。

TooManyRequests 429

用户在给定的时间内发送了过多的请求。 响应应包含说明条件的详细信息,并可能包含 一个“重试后” 标头,指示在发出新请求之前等待多长时间。

IETF RFC 6585 中记录了此状态代码。

Unauthorized 401

请求的资源需要身份验证。 WWW-Authenticate 标头包含如何执行身份验证的详细信息。

UnprocessableEntity 422

服务器了解请求实体的内容类型,并且请求实体的语法正确,但服务器无法处理包含的指令。

此状态代码是用于 Web 分布式创作和版本控制 (WebDAV) 的 HTTP 扩展。 IETF RFC 4918 中记录了此状态代码。

UnsupportedMediaType 415

请求的类型不受支持。

UpgradeRequired 426

客户端应切换到其他协议,例如 TLS/1.0。

IETF RFC 2917 中记录了此状态代码。

UseProxy 305

请求应使用 Location 标头中指定的 URI 处的代理服务器。

VariantAlsoNegotiates 506

服务器出现内部配置错误。 所选变体资源配置为进行透明内容协商本身,因此不是协商过程中的适当终结点。

IETF RFC 2295 中记录了此状态代码。

注解

HttpStatusCode 枚举包含 RFC 2616 中 IETF 为 HTTP 1.1 和相关 RFC 定义的状态代码的值。

HTTP 请求的状态包含在 HttpResponseMessage 对象的 StatusCode 属性中。

适用于

另请参阅