HttpResponseMessage.EnsureSuccessStatusCode Método

Definição

Namespace:

System.Net.Http

Assemblies:

netstandard.dll, System.Net.Http.dll

Origem:

HttpResponseMessage.cs

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

HttpResponseMessage

A mensagem de resposta HTTP se a chamada for bem-sucedida.

Exceções

HttpRequestException

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 não Contentnullestiver, esse método também chamará Dispose recursos gerenciados e não gerenciados gratuitos. A partir do .NET Core 3.0, o conteúdo não é descartado.