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.
Gerará uma exceção se a propriedade HttpResponseMessage.IsSuccessStatusCode para o objeto de resposta HTTP for false
; se for true
, nenhuma exceção será gerada.
public:
virtual HttpResponseMessage ^ EnsureSuccessStatusCode() = EnsureSuccessStatusCode;
HttpResponseMessage EnsureSuccessStatusCode();
public HttpResponseMessage EnsureSuccessStatusCode();
function ensureSuccessStatusCode()
Public Function EnsureSuccessStatusCode () As HttpResponseMessage
Retornos
Se nenhuma exceção for gerada, o objeto de resposta HTTP será retornado.
Comentários
Se o servidor não retornar um HttpStatusCode bem-sucedido no intervalo bem-sucedido (200-299) para a solicitação, a propriedade HttpResponseMessage.IsSuccessStatusCode será definida false
como . Chamar EnsureSuccessStatusCode faz com que o valor de IsSuccessStatusCode seja verificado e uma exceção gerada se esse valor for false
. Nenhuma exceção será gerada se o valor for true
.
Qualquer exceção gerada é específica para a projeção de linguagem Windows Runtime na qual você está programando. Para C#, por exemplo, um System.Exception é gerado e essa exceção inclui um HRESULT que codifica o erro HTTP original. Por exemplo, se o HRESULT for 0x80190194, remova o 0x8019000 para fornecer 0x00000194, que é decimal 404.
Para evitar lidar com exceções, marcar a propriedade HttpResponseMessage.IsSuccessStatusCode em vez de chamar EnsureSuccessStatusCode.