HttpResponseMessage Classe
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.
Représente un message de réponse HTTP, y compris le code d’état et les données.
public ref class HttpResponseMessage : IDisposable
public class HttpResponseMessage : IDisposable
type HttpResponseMessage = class
interface IDisposable
Public Class HttpResponseMessage
Implements IDisposable
- Héritage
-
HttpResponseMessage
- Implémente
Exemples
// HttpClient is intended to be instantiated once per application, rather than per-use. See Remarks.
static readonly HttpClient client = new HttpClient();
static async Task Main()
{
// Call asynchronous network methods in a try/catch block to handle exceptions.
try
{
using HttpResponseMessage response = await client.GetAsync("http://www.contoso.com/");
response.EnsureSuccessStatusCode();
string responseBody = await response.Content.ReadAsStringAsync();
// Above three lines can be replaced with new helper method below
// string responseBody = await client.GetStringAsync(uri);
Console.WriteLine(responseBody);
}
catch (HttpRequestException e)
{
Console.WriteLine("\nException Caught!");
Console.WriteLine("Message :{0} ", e.Message);
}
}
open System.Net.Http
// HttpClient is intended to be instantiated once per application, rather than per-use. See Remarks.
let client = new HttpClient()
let main =
task {
// Call asynchronous network methods in a try/catch block to handle exceptions.
try
use! response = client.GetAsync "http://www.contoso.com/"
response.EnsureSuccessStatusCode() |> ignore
let! responseBody = response.Content.ReadAsStringAsync()
// Above three lines can be replaced with new helper method below
// let! responseBody = client.GetStringAsync uri
printfn $"{responseBody}"
with
| :? HttpRequestException as e ->
printfn "\nException Caught!"
printfn $"Message :{e.Message} "
}
main.Wait()
' HttpClient is intended to be instantiated once per application, rather than per-use. See Remarks.
Shared ReadOnly client As HttpClient = New HttpClient()
Private Shared Async Function Main() As Task
' Call asynchronous network methods in a try/catch block to handle exceptions.
Try
Using response As HttpResponseMessage = Await client.GetAsync("http://www.contoso.com/")
response.EnsureSuccessStatusCode()
Dim responseBody As String = Await response.Content.ReadAsStringAsync()
' Above three lines can be replaced with new helper method below
' Dim responseBody As String = Await client.GetStringAsync(uri)
Console.WriteLine(responseBody)
End Using
Catch e As HttpRequestException
Console.WriteLine(Environment.NewLine & "Exception Caught!")
Console.WriteLine("Message :{0} ", e.Message)
End Try
End Function
L’exemple de code précédent utilise un point d’entrée async Task Main() . Cette fonctionnalité nécessite C# 7.1 ou version ultérieure.
Remarques
Un moyen courant d’obtenir un HttpResponseMessage est de l’une des HttpClient.SendAsync(HttpRequestMessage) méthodes.
Constructeurs
| Nom | Description |
|---|---|
| HttpResponseMessage() |
Initialise une nouvelle instance de la classe HttpResponseMessage. |
| HttpResponseMessage(HttpStatusCode) |
Initialise une nouvelle instance de la HttpResponseMessage classe avec un élément spécifique StatusCode. |
Propriétés
| Nom | Description |
|---|---|
| Content |
Obtient ou définit le contenu d’un message de réponse HTTP. |
| Headers |
Obtient la collection d’en-têtes de réponse HTTP. |
| IsSuccessStatusCode |
Obtient une valeur qui indique si la réponse HTTP a réussi. |
| ReasonPhrase |
Obtient ou définit l’expression de raison, qui est généralement envoyée par les serveurs avec le code d’état. |
| RequestMessage |
Obtient ou définit le message de requête qui a conduit à ce message de réponse. |
| StatusCode |
Obtient ou définit le code d’état de la réponse HTTP. |
| TrailingHeaders |
Obtient la collection d’en-têtes de fin inclus dans une réponse HTTP. |
| Version |
Obtient ou définit la version du message HTTP. |
Méthodes
| Nom | Description |
|---|---|
| Dispose() |
Libère les ressources non managées et supprime les ressources non managées utilisées par le HttpResponseMessage. |
| Dispose(Boolean) |
Libère les ressources non managées utilisées par les HttpResponseMessage ressources gérées et supprime éventuellement les ressources gérées. |
| EnsureSuccessStatusCode() |
Lève une exception si la IsSuccessStatusCode propriété de la réponse HTTP est |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. |
Méthodes d’extension
| Nom | Description |
|---|---|
| ToMessage(HttpResponseMessage) |
Crée une Message instance à partir d’une HttpResponseMessage instance. |