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 avec le code et les données d'état.
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
Une méthode courante pour obtenir un HttpResponseMessage est l’une des HttpClient.SendAsync(HttpRequestMessage) méthodes.
Constructeurs
HttpResponseMessage() |
Initialise une nouvelle instance de la classe HttpResponseMessage. |
HttpResponseMessage(HttpStatusCode) |
Initialise une nouvelle instance de la classe HttpResponseMessage avec un StatusCode spécifique. |
Propriétés
Content |
Récupère 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 |
Récupère ou définit l’expression du motif qui est généralement envoyée par les serveurs avec le code d’état. |
RequestMessage |
Récupère 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
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 le HttpResponseMessage et supprime éventuellement les ressources managées. |
EnsureSuccessStatusCode() |
Lève une exception si la propriété IsSuccessStatusCode pour la réponse HTTP est |
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
ToString() |
Retourne une chaîne qui représente l'objet actuel. |
Méthodes d’extension
ToMessage(HttpResponseMessage) |
Crée une instance Message à partir d'une instance HttpResponseMessage. |