HttpResponseMessage Klasse

Definition

Stellt eine HTTP-Antwortnachricht einschließlich Statuscode und 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 Elements besteht aus einer der HttpClient.SendAsync(HttpRequestMessage) Methoden.

Konstruktoren

Name Beschreibung
HttpResponseMessage()

Initialisiert eine neue Instanz der HttpResponseMessage-Klasse.

HttpResponseMessage(HttpStatusCode)

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

Eigenschaften

Name Beschreibung
Content

Dient zum Abrufen oder Festlegen des Inhalts einer HTTP-Antwortnachricht.

Headers

Ruft die Auflistung von HTTP-Antwortheadern ab.

IsSuccessStatusCode

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

ReasonPhrase

Dient zum Abrufen oder Festlegen des Grundausdrucks, der in der Regel von Servern zusammen mit dem Statuscode gesendet wird.

RequestMessage

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

StatusCode

Dient zum Abrufen oder Festlegen des Statuscodes der HTTP-Antwort.

TrailingHeaders

Ruft die Auflistung der nachfolgenden Header ab, die in einer HTTP-Antwort enthalten sind.

Version

Ruft die HTTP-Nachrichtenversion ab oder legt sie fest.

Methoden

Name Beschreibung
Dispose()

Gibt die nicht verwalteten Ressourcen frei und entsorgt nicht verwaltete Ressourcen, die von der HttpResponseMessage.

Dispose(Boolean)

Gibt die nicht verwalteten Ressourcen frei, die von den HttpResponseMessage verwalteten Ressourcen verwendet werden, und entfernt optional die verwalteten Ressourcen.

EnsureSuccessStatusCode()

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

Equals(Object)

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

(Geerbt von Object)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToString()

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

Erweiterungsmethoden

Name Beschreibung
ToMessage(HttpResponseMessage)

Erstellt eine Message Instanz aus einer HttpResponseMessage Instanz.

Gilt für: