HttpResponseMessage.EnsureSuccessStatusCode Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zgłasza wyjątek, jeśli IsSuccessStatusCode właściwość odpowiedzi HTTP to false.
public:
System::Net::Http::HttpResponseMessage ^ EnsureSuccessStatusCode();public System.Net.Http.HttpResponseMessage EnsureSuccessStatusCode();member this.EnsureSuccessStatusCode : unit -> System.Net.Http.HttpResponseMessagePublic Function EnsureSuccessStatusCode () As HttpResponseMessageZwraca
Komunikat odpowiedzi HTTP, jeśli wywołanie zakończy się pomyślnie.
Wyjątki
Odpowiedź HTTP nie powiedzie się.
Uwagi
Metoda EnsureSuccessStatusCode zgłasza wyjątek HttpRequestException , jeśli StatusCode znajduje się poza zakresem 200–299 (zakres kodów stanu wskazujący powodzenie zgodnie ze standardem).
W niektórych scenariuszach może być potrzebna większa kontrola nad tym, które kody stanu są uznawane za pomyślne; na przykład interfejs API może zawsze zwracać wartość 200 OK. W takich przypadkach zalecamy ręczne sprawdzenie, czy StatusCode jest zgodna z oczekiwaną wartością.
W .NET Framework, jeśli Content nie jest null, ta metoda wywołuje również Dispose do bezpłatnych zasobów zarządzanych i niezarządzanych. Począwszy od .NET Core 3.0, zawartość nie jest usuwana.
