.NET 中的 HTTP 支援

超文字傳輸通訊協定 (或 HTTP) 是一種從網頁伺服器要求資源的通訊協定。 System.Net.Http.HttpClient 類別可用於傳送 HTTP 要求和接收來自資源 (由 URI 識別) 的 HTTP 回應。網路上許多可用的資源類型，且 HTTP 會定義一組要求方法來存取這些資源。

HTTP 要求方法

要求方法會透過數個因素來區分，首先會依「動詞」來區分，但也透過下列特性來區分：

如果要求方法可以成功處理多次，而不需變更結果，則要求方法是等冪的。如需詳細資訊，請參閱 RFC 9110：9.2.2.等冪方法 (英文)。
當可以儲存要求方法的對應回應以供重複使用時，即為可快取要求方法。如需詳細資訊，請參閱 RFC 9110：章節 9.2.3.方法與快取 (英文)。
如果要求方法未修改資源的狀態，則會被視為安全的方法。所有安全方法也是等冪方法，但並非所有等冪方法都視為安全。如需詳細資訊，請參閱 RFC 9110：章節 9.2.1.安全方法 (英文)。

HTTP 方法	具等冪性	可快取	安全
`GET`	✔️ 是	✔️ 是	✔️ 是
`POST`	❌ 否	⚠️ ^†很少	❌ 否
`PUT`	✔️ 是	❌ 否	❌ 否
`PATCH`	❌ 否	❌ 否	❌ 否
`DELETE`	✔️ 是	❌ 否	❌ 否
`HEAD`	✔️ 是	✔️ 是	✔️ 是
`OPTIONS`	✔️ 是	❌ 否	✔️ 是
`TRACE`	✔️ 是	❌ 否	✔️ 是
`CONNECT`	❌ 否	❌ 否	❌ 否

^†只有在適當的 Cache-Control 或 Expires 回應標頭存在時，才能快取 POST 方法。這在實務上非常罕見。

.NET 透過 HttpClient 為 HTTP 通訊協定提供完整支援，該通訊協定是大部分網際網路流量的來源。如需詳細資訊，請參閱使用 HttpClient 類別提出 HTTP 要求。應用程式藉由捕捉 HttpRequestException，以便接收 HTTP 通訊協定錯誤。如果呼叫的方法未傳回回應訊息，則會在具有 HttpResponseMessage.StatusCode 的 HttpResponseMessage 中，或在具有 HttpRequestException.StatusCode 的 HttpRequestException 中報告 HTTP 狀態碼。如需錯誤處理的詳細資訊，請參閱 HTTP 錯誤處理，如需狀態碼的詳細資訊，請參閱 RFC 9110、HTTP 語意：狀態碼。

參考狀態碼會反映過渡回應。大部分的過渡回應，例如 HttpStatusCode.Continue，都是在 HttpClient 內部處理，且永遠不會向使用者呈現。

HTTP 狀態碼	`HttpStatusCode`
`100`	HttpStatusCode.Continue
`101`	HttpStatusCode.SwitchingProtocols
`102`	HttpStatusCode.Processing
`103`	HttpStatusCode.EarlyHints

成功狀態碼表示已成功接收、了解及接受用戶端的要求。

HTTP 狀態碼	`HttpStatusCode`
`200`	HttpStatusCode.OK
`201`	HttpStatusCode.Created
`202`	HttpStatusCode.Accepted
`203`	HttpStatusCode.NonAuthoritativeInformation
`204`	HttpStatusCode.NoContent
`205`	HttpStatusCode.ResetContent
`206`	HttpStatusCode.PartialContent
`207`	HttpStatusCode.MultiStatus
`208`	HttpStatusCode.AlreadyReported
`226`	HttpStatusCode.IMUsed

重新導向狀態碼需要使用者代理程式採取動作以完成要求。預設會開啟自動重新導向，可以使用 HttpClientHandler.AllowAutoRedirect 或 SocketsHttpHandler.AllowAutoRedirect 進行變更。

HTTP 狀態碼	`HttpStatusCode`
`300`	HttpStatusCode.MultipleChoices 或 HttpStatusCode.Ambiguous
`301`	HttpStatusCode.MovedPermanently 或 HttpStatusCode.Moved
`302`	HttpStatusCode.Found 或 HttpStatusCode.Redirect
`303`	HttpStatusCode.SeeOther 或 HttpStatusCode.RedirectMethod
`304`	HttpStatusCode.NotModified
`305`	HttpStatusCode.UseProxy
`306`	HttpStatusCode.Unused
`307`	HttpStatusCode.TemporaryRedirect 或 HttpStatusCode.RedirectKeepVerb
`308`	HttpStatusCode.PermanentRedirect

用戶端錯誤狀態碼表示用戶端的要求無效。

HTTP 狀態碼	`HttpStatusCode`
`400`	HttpStatusCode.BadRequest
`401`	HttpStatusCode.Unauthorized
`402`	HttpStatusCode.PaymentRequired
`403`	HttpStatusCode.Forbidden
`404`	HttpStatusCode.NotFound
`405`	HttpStatusCode.MethodNotAllowed
`406`	HttpStatusCode.NotAcceptable
`407`	HttpStatusCode.ProxyAuthenticationRequired
`408`	HttpStatusCode.RequestTimeout
`409`	HttpStatusCode.Conflict
`410`	HttpStatusCode.Gone
`411`	HttpStatusCode.LengthRequired
`412`	HttpStatusCode.PreconditionFailed
`413`	HttpStatusCode.RequestEntityTooLarge
`414`	HttpStatusCode.RequestUriTooLong
`415`	HttpStatusCode.UnsupportedMediaType
`416`	HttpStatusCode.RequestedRangeNotSatisfiable
`417`	HttpStatusCode.ExpectationFailed
`418`	我是茶壺 🫖
`421`	HttpStatusCode.MisdirectedRequest
`422`	HttpStatusCode.UnprocessableEntity
`423`	HttpStatusCode.Locked
`424`	HttpStatusCode.FailedDependency
`426`	HttpStatusCode.UpgradeRequired
`428`	HttpStatusCode.PreconditionRequired
`429`	HttpStatusCode.TooManyRequests
`431`	HttpStatusCode.RequestHeaderFieldsTooLarge
`451`	HttpStatusCode.UnavailableForLegalReasons

伺服器錯誤狀態碼表示伺服器遇到無法滿足要求的非預期狀況。

HTTP 狀態碼	`HttpStatusCode`
`500`	HttpStatusCode.InternalServerError
`501`	HttpStatusCode.NotImplemented
`502`	HttpStatusCode.BadGateway
`503`	HttpStatusCode.ServiceUnavailable
`504`	HttpStatusCode.GatewayTimeout
`505`	HttpStatusCode.HttpVersionNotSupported
`506`	HttpStatusCode.VariantAlsoNegotiates
`507`	HttpStatusCode.InsufficientStorage
`508`	HttpStatusCode.LoopDetected
`510`	HttpStatusCode.NotExtended
`511`	HttpStatusCode.NetworkAuthenticationRequired