HttpResponseMessage.EnsureSuccessStatusCode 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
如果 IsSuccessStatusCode HTTP 响应的属性为 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
返回
如果调用成功,则为 HTTP 响应消息。
例外
HTTP 响应失败。
注解
该方法 EnsureSuccessStatusCode 将引发 HttpRequestException if StatusCode 不在 200-299 范围内(指示根据标准成功的状态代码范围)。
在某些情况下,可能需要更好地控制哪些状态代码被视为成功;例如,API 可能始终返回 200 OK。 在这种情况下,我们建议手动检查是否 StatusCode 与预期值匹配。
在 .NET Framework 中,如果 Content 不是 null,此方法还会调用 Dispose 免费托管和非托管资源。 从 .NET Core 3.0 开始,不会释放内容。