HttpResponseMessage Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Představuje zprávu odpovědi HTTP včetně stavového kódu a dat.
public ref class HttpResponseMessage : IDisposable
public class HttpResponseMessage : IDisposable
type HttpResponseMessage = class
interface IDisposable
Public Class HttpResponseMessage
Implements IDisposable
- Dědičnost
-
HttpResponseMessage
- Implementuje
Příklady
// 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
Předchozí příklad kódu používá async Task Main() vstupní bod. Tato funkce vyžaduje C# 7.1 nebo novější.
Poznámky
Běžný způsob, jak získat, HttpResponseMessage je z jedné z HttpClient.SendAsync(HttpRequestMessage) metod.
Konstruktory
| Name | Description |
|---|---|
| HttpResponseMessage() |
Inicializuje novou instanci HttpResponseMessage třídy. |
| HttpResponseMessage(HttpStatusCode) |
Inicializuje novou instanci HttpResponseMessage třídy s konkrétním StatusCode. |
Vlastnosti
| Name | Description |
|---|---|
| Content |
Získá nebo nastaví obsah zprávy http odpovědi. |
| Headers |
Získá kolekci hlaviček odpovědí HTTP. |
| IsSuccessStatusCode |
Získá hodnotu, která označuje, zda byla odpověď HTTP úspěšná. |
| ReasonPhrase |
Získá nebo nastaví důvodovou frázi, která se obvykle odesílá servery společně se stavovým kódem. |
| RequestMessage |
Získá nebo nastaví zprávu požadavku, která vedla k této zprávě odpovědi. |
| StatusCode |
Získá nebo nastaví stavový kód odpovědi HTTP. |
| TrailingHeaders |
Získá kolekci koncových hlaviček zahrnutých v odpovědi HTTP. |
| Version |
Získá nebo nastaví verzi zprávy HTTP. |
Metody
| Name | Description |
|---|---|
| Dispose() |
Uvolní nespravované prostředky a odstraní nespravované prostředky používané nástrojem HttpResponseMessage. |
| Dispose(Boolean) |
Uvolní nespravované prostředky používané spravovanými HttpResponseMessage prostředky a volitelně zlikviduje spravované prostředky. |
| EnsureSuccessStatusCode() |
Vyvolá výjimku, pokud IsSuccessStatusCode je vlastnost pro odpověď |
| Equals(Object) |
Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
| GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. |
Metody rozšíření
| Name | Description |
|---|---|
| ToMessage(HttpResponseMessage) |
Message Vytvoří instanci z HttpResponseMessage instance. |