HttpResponseMessage.EnsureSuccessStatusCode Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает исключение, если свойство HttpResponseMessage.IsSuccessStatusCode для объекта ответа HTTP равно false
; если это true
, исключение не создается.
public:
virtual HttpResponseMessage ^ EnsureSuccessStatusCode() = EnsureSuccessStatusCode;
HttpResponseMessage EnsureSuccessStatusCode();
public HttpResponseMessage EnsureSuccessStatusCode();
function ensureSuccessStatusCode()
Public Function EnsureSuccessStatusCode () As HttpResponseMessage
Возвращаемое значение
Если исключение не возникает, возвращается объект ответа HTTP.
Комментарии
Если сервер не возвращает успешное значение HttpStatusCode в диапазоне Успешно (200–299) для запроса, то свойству HttpResponseMessage.IsSuccessStatusCode присваивается значение false
. Вызов EnsureSuccessStatusCode приводит к проверке значения IsSuccessStatusCode и возникновению исключения, если это значение равно false
. Исключение не возникает, если значение равно true
.
Любое исключение зависит от проекции языка среда выполнения Windows, в которую вы программируетсяе. Например, для C# возникает исключение System.Exception , и это исключение включает HRESULT , который кодирует исходную ошибку HTTP. Например, если HRESULT имеет значение 0x80190194, удалите 0x8019000, чтобы предоставить 0x00000194( десятичное число 404).
Чтобы избежать обработки исключений, проверка свойство HttpResponseMessage.IsSuccessStatusCode вместо вызова EnsureSuccessStatusCode.