Freigeben über


HttpResponseMessage Klasse

Definition

Stellt eine HTTP-Antwortnachricht einschließlich den Statuscodes und der Daten dar.

public ref class HttpResponseMessage : IDisposable
public class HttpResponseMessage : IDisposable
type HttpResponseMessage = class
    interface IDisposable
Public Class HttpResponseMessage
Implements IDisposable
Vererbung
HttpResponseMessage
Implementiert

Beispiele

// 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

Im vorherigen Codebeispiel wird ein async Task Main() Einstiegspunkt verwendet. Für dieses Feature ist C# 7.1 oder höher erforderlich.

Hinweise

Eine gängige Methode zum Abrufen eines HttpResponseMessage ist eine der HttpClient.SendAsync(HttpRequestMessage) Methoden.

Konstruktoren

HttpResponseMessage()

Initialisiert eine neue Instanz der HttpResponseMessage-Klasse.

HttpResponseMessage(HttpStatusCode)

Initialisiert eine neue Instanz der HttpResponseMessage-Klasse mit einem bestimmten StatusCode.

Eigenschaften

Content

Ruft den Inhalt einer HTTP-Antwortnachricht ab oder legt diesen fest.

Headers

Ruft die Sammlung von HTTP-Antwortheadern ab.

IsSuccessStatusCode

Ruft einen Wert ab, der anzeigt, ob die HTTP-Antwort erfolgreich war.

ReasonPhrase

Ruft den Ursachenausdruck ab, der in der Regel von Servern zusammen mit dem Statuscode übertragen wird, oder legt ihn fest.

RequestMessage

Ruft die Anforderungsnachricht ab, die zu dieser Antwortnachricht geführt hat, oder legt sie fest.

StatusCode

Ruft den Statuscode der HTTP-Antwort ab oder legt ihn fest.

TrailingHeaders

Ruft die Auflistung von nachfolgenden Headern in einer HTTP-Antwort ab.

Version

Ruft die HTTP-Nachrichtenversion ab oder legt sie fest.

Methoden

Dispose()

Gibt die vom HttpResponseMessage verwendeten, nicht verwalteten Ressourcen frei und verwirft die nicht verwalteten Ressourcen.

Dispose(Boolean)

Gibt die vom HttpResponseMessage verwendeten, nicht verwalteten Ressourcen frei und verwirft optional auch die verwalteten Ressourcen.

EnsureSuccessStatusCode()

Löst eine Ausnahme aus, wenn die IsSuccessStatusCode-Eigenschaft für die HTTP-Antwort false ist.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

Erweiterungsmethoden

ToMessage(HttpResponseMessage)

Erstellt eine Message-Instanz aus einer HttpResponseMessage-Instanz.

Gilt für: