HttpResponseMessage.EnsureSuccessStatusCode 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
如果 HTTP 响应对象的 HttpResponseMessage.IsSuccessStatusCode 属性为 false
,则引发异常;如果是 true
,则不引发异常。
public:
virtual HttpResponseMessage ^ EnsureSuccessStatusCode() = EnsureSuccessStatusCode;
HttpResponseMessage EnsureSuccessStatusCode();
public HttpResponseMessage EnsureSuccessStatusCode();
function ensureSuccessStatusCode()
Public Function EnsureSuccessStatusCode () As HttpResponseMessage
返回
如果未引发异常,则返回 HTTP 响应对象。
注解
如果服务器未返回请求 (200-299) 成功范围内的成功HttpStatusCode,则 HttpResponseMessage.IsSuccessStatusCode 属性设置为 false
。 调用 EnsureSuccessStatusCode 会导致检查 IsSuccessStatusCode 的值,如果该值为 false
,则会引发异常。 如果 值为 true
,则不会引发异常。
引发的任何异常都特定于你正在编程的Windows 运行时语言投影。 例如,对于 C#,将引发 System.Exception ,该异常包括对原始 HTTP 错误进行编码的 HRESULT 。 例如,如果 HRESULT 是0x80190194,则删除0x8019000来提供0x00000194,即十进制 404。
为了避免处理异常,检查 HttpResponseMessage.IsSuccessStatusCode 属性,而不是调用 EnsureSuccessStatusCode。