HttpResponseMessage.EnsureSuccessStatusCode 方法

定義

命名空間:

System.Net.Http

組件:

netstandard.dll, System.Net.Http.dll

來源:

HttpResponseMessage.cs

若 HTTP 回應的 IsSuccessStatusCode 屬性為 false，則拋出例外。

public:
 System::Net::Http::HttpResponseMessage ^ EnsureSuccessStatusCode();

public System.Net.Http.HttpResponseMessage EnsureSuccessStatusCode();

member this.EnsureSuccessStatusCode : unit -> System.Net.Http.HttpResponseMessage

Public Function EnsureSuccessStatusCode () As HttpResponseMessage

傳回

HttpResponseMessage

如果呼叫成功，則會收到 HTTP 回應訊息。

例外狀況

HttpRequestException

HTTP 回應未成功。

備註

此 EnsureSuccessStatusCode 方法會拋 HttpRequestException 出一個「如果 StatusCode 」超出 200-299（標準中表示成功狀態碼的範圍）之外。 在某些情況下，您可能需要更多控制哪些狀態碼被視為成功;例如，一個 API 可能被期望總是回傳 200 OK。 在這種情況下，我們建議手動檢查是否 StatusCode 符合預期值。 在 .NET Framework 中，若 不是 Contentnull，此方法也會呼叫 Dispose 自由的受管資源與非受管資源。 從 .NET Core 3.0 開始，內容不再被丟棄。