HttpResponseMessage.EnsureSuccessStatusCode Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Gera uma exceção se a IsSuccessStatusCode propriedade para a resposta HTTP for 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
Retornos
A mensagem de resposta HTTP se a chamada for bem-sucedida.
Exceções
A resposta HTTP não foi bem-sucedida.
Comentários
O EnsureSuccessStatusCode método gera um HttpRequestException se StatusCode estiver fora do intervalo de 200 a 299 (o intervalo de códigos de status que indica êxito de acordo com o padrão).
Em alguns cenários, talvez você precise de mais controle sobre quais códigos de status são considerados bem-sucedidos; por exemplo, uma API pode ser esperada para sempre retornar 200 OK. Nesses casos, recomendamos verificar manualmente se StatusCode corresponde ao valor esperado.
No .NET Framework, se o Content não for null, esse método também chamará Dispose para liberar recursos gerenciados e não gerenciados. A partir do .NET Core 3.0, o conteúdo não é descartado.