Compartilhar via


HttpResponseMessage.EnsureSuccessStatusCode Método

Definição

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 falsecomo . 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.

Aplica-se a

Confira também