HttpResponseMessage Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 |
| 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. |