HttpResponseMessage.EnsureSuccessStatusCode Metoda

Definice

Obor názvů:

System.Net.Http

Sestavení:

netstandard.dll, System.Net.Http.dll

Zdroj:

HttpResponseMessage.cs

Vyvolá výjimku, pokud IsSuccessStatusCode je vlastnost pro odpověď falseHTTP .

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

Návraty

HttpResponseMessage

Zpráva odpovědi HTTP, pokud je volání úspěšné.

Výjimky

HttpRequestException

Odpověď HTTP je neúspěšná.

Poznámky

Metoda EnsureSuccessStatusCode vyvolá výjimku HttpRequestException if StatusCode mimo rozsah 200–299 (rozsah stavových kódů označujících úspěch podle standardu).

V některých scénářích můžete potřebovat větší kontrolu nad tím, které stavové kódy se považují za úspěšné; Například by se dalo očekávat, že rozhraní API vždy vrátí 200 OK. V takových případech doporučujeme ručně zkontrolovat, jestli StatusCode odpovídá očekávané hodnotě.

V .NET Framework, pokud Content není null, tato metoda také volá Dispose na bezplatné spravované a nespravované prostředky. Počínaje verzí .NET Core 3.0 se obsah neodhodí.