HttpResponseMessage.EnsureSuccessStatusCode Метод

Определение

Пространство имен:

System.Net.Http

Сборки:

netstandard.dll, System.Net.Http.dll

Исходный код:

HttpResponseMessage.cs

Создает исключение, если 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

Возвращаемое значение

HttpResponseMessage

Сообщение HTTP-ответа, если вызов выполнен успешно.

Исключения

HttpRequestException

Ответ HTTP завершается неудачно.

Комментарии

Метод EnsureSuccessStatusCode вызывает исключение HttpRequestException if StatusCode вне диапазона 200–299 (диапазон кодов состояния, указывающих на успех в соответствии со стандартом). В некоторых сценариях может потребоваться больше контроля над кодами состояния, которые считаются успешными; Например, api может всегда возвращать 200 OK. В таких случаях рекомендуется вручную проверить, соответствует ли StatusCode ожидаемое значение. В .NET Framework этот Contentnullметод также вызывает бесплатные Dispose управляемые и неуправляемые ресурсы. Начиная с .NET Core 3.0 содержимое не удаляется.