Compartilhar via


HttpResponseMessage.EnsureSuccessStatusCode Método

Definição

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.

Aplica-se a