HttpResponseMessage.EnsureSuccessStatusCode Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Lança uma exceção se a IsSuccessStatusCode propriedade da resposta HTTP for false.
public:
System::Net::Http::HttpResponseMessage ^ EnsureSuccessStatusCode();public System.Net.Http.HttpResponseMessage EnsureSuccessStatusCode();member this.EnsureSuccessStatusCode : unit -> System.Net.Http.HttpResponseMessagePublic Function EnsureSuccessStatusCode () As HttpResponseMessageDevoluções
A mensagem de resposta HTTP se a chamada for bem-sucedida.
Exceções
A resposta HTTP não tem sucesso.
Observações
O EnsureSuccessStatusCode método lança um HttpRequestException se StatusCode está fora do intervalo 200-299 (o intervalo de códigos de estado que indicam sucesso segundo o padrão).
Em alguns cenários, pode ser necessário mais controlo sobre quais os códigos de estado considerados bem-sucedidos; por exemplo, uma API pode ser esperada que devolva 200 OKsempre . Nesses casos, recomendamos verificar manualmente se StatusCode corresponde ao valor esperado.
Na .NET Framework, se o Content não for null, este método também chama Dispose a recursos geridos e não geridos. A partir do .NET Core 3.0, o conteúdo não é descartado.