HttpResponseMessage.EnsureSuccessStatusCode Méthode

Définition

Espace de noms:

Windows.Web.Http

Lève une exception si la propriété HttpResponseMessage.IsSuccessStatusCode pour l’objet de réponse HTTP est ; si elle est falsetrue, aucune exception n’est levée.

public:
 virtual HttpResponseMessage ^ EnsureSuccessStatusCode() = EnsureSuccessStatusCode;

HttpResponseMessage EnsureSuccessStatusCode();

public HttpResponseMessage EnsureSuccessStatusCode();

function ensureSuccessStatusCode()

Public Function EnsureSuccessStatusCode () As HttpResponseMessage

Retours

HttpResponseMessage

Si aucune exception n’est levée, l’objet de réponse HTTP est retourné.

Remarques

Si le serveur ne retourne pas un HttpStatusCode réussi dans la plage réussie (200-299) pour la requête, la propriété HttpResponseMessage.IsSuccessStatusCode est définie sur false. L’appel de EnsureSuccessStatusCode entraîne la vérification de la valeur isSuccessStatusCode et la levée d’une exception si cette valeur est false. Aucune exception n’est levée si la valeur est true.

Toute exception levée est spécifique à la projection de langage Windows Runtime dans laquelle vous programmez. Pour C#, par exemple, une exception System.Exception est levée, et cette exception inclut un HRESULT qui encode l’erreur HTTP d’origine. Par exemple, si le HRESULT est 0x80190194, supprimez le 0x8019000 pour donner 0x00000194, qui est décimal 404.

Pour éviter les exceptions, case activée la propriété HttpResponseMessage.IsSuccessStatusCode au lieu d’appeler EnsureSuccessStatusCode.

Voir aussi

• HttpStatusCode
• HttpResponseMessage.IsSuccessStatusCode