HttpResponseMessage.EnsureSuccessStatusCode Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Lève une exception si la propriété HttpResponseMessage.IsSuccessStatusCode pour l’objet de réponse HTTP est ; si elle est false
true
, aucune exception n’est levée.
public:
virtual HttpResponseMessage ^ EnsureSuccessStatusCode() = EnsureSuccessStatusCode;
HttpResponseMessage EnsureSuccessStatusCode();
public HttpResponseMessage EnsureSuccessStatusCode();
function ensureSuccessStatusCode()
Public Function EnsureSuccessStatusCode () As HttpResponseMessage
Retours
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.