HttpResponseMessage.EnsureSuccessStatusCode メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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
返品
呼び出しが成功した場合の HTTP 応答メッセージ。
例外
HTTP 応答は失敗します。
注釈
EnsureSuccessStatusCodeメソッドは、StatusCodeが 200 から 299 の範囲外 (標準に従って成功を示す状態コードの範囲) の範囲外である場合、HttpRequestExceptionをスローします。
一部のシナリオでは、成功と見なされる状態コードをより詳細に制御する必要がある場合があります。たとえば、API は常に 200 OKを返す必要があります。 このような場合は、 StatusCode が期待値と一致するかどうかを手動で確認することをお勧めします。
.NET Framework では、 Content が nullされていない場合、このメソッドはマネージド リソースとアンマネージド リソースを解放するために Dispose も呼び出します。 .NET Core 3.0 以降では、コンテンツは破棄されません。