HttpResponseMessage.EnsureSuccessStatusCode Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
Zpráva odpovědi HTTP, pokud je volání úspěšné.
Výjimky
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 rozhraní .NET Framework, pokud Content není null, tato metoda také volá Dispose bezplatné spravované a nespravované prostředky. Od verze .NET Core 3.0 se obsah neodebral.