Freigeben über

HttpRequestMessage Klasse

  • Referenz

Definition

Namespace:
Windows.Web.Http
Bearbeiten

Stellt eine HTTP-Anforderungsnachricht einschließlich Headern dar.

public ref class HttpRequestMessage sealed : IClosable, IStringable
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Web.Http.IHttpRequestMessageFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class HttpRequestMessage final : IClosable, IStringable
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Web.Http.IHttpRequestMessageFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class HttpRequestMessage final : IClosable, IStringable
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Web.Http.IHttpRequestMessageFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class HttpRequestMessage : System.IDisposable, IStringable
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Web.Http.IHttpRequestMessageFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class HttpRequestMessage : System.IDisposable, IStringable
function HttpRequestMessage(method, uri)
Public NotInheritable Class HttpRequestMessage
Implements IDisposable, IStringable
Vererbung
Object Platform::Object IInspectable HttpRequestMessage
Attribute
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute
Implementiert
IClosable IDisposable IStringable

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Die HttpRequestMessage-Klasse enthält Header, das HTTP-Verb und potenziell Daten. Diese Klasse wird häufig von Entwicklern verwendet, die zusätzliche Kontrolle über HTTP-Anforderungen benötigen. Zu den gängigen Beispielen gehören die folgenden:

  • So untersuchen Sie die zugrunde liegenden SSL/TLS-Transportinformationen.
  • So verwenden Sie eine weniger gängige HTTP-Methode.
  • So legen Sie Anforderungseigenschaften für httpRequestMessage explizit fest.

In diesen Fällen verwendet eine App einen der HttpRequestMessage-Konstruktoren, um eine HttpRequestMessage-instance zu erstellen. Die App legt bei Bedarf verschiedene Eigenschaften für httpRequestMessage fest. Anschließend wird die HttpRequestMessage als Parameter an eine der HttpClient.SendRequestAsync-Methoden übergeben.

Eine Reihe von praktischen Methoden für die HttpClient-Klasse erstellt automatisch ein HttpRequestMessage-Objekt für die App. Hierzu zählen folgende Möglichkeiten:

Alle Filter, die Sie der Filterpipeline hinzufügen, werden an das HttpRequestMessage-Objekt übergeben, unabhängig davon, ob es explizit von der App angegeben oder automatisch für Sie erstellt wurde.

Konstruktoren

HttpRequestMessage()

Initialisiert eine neue instance der HttpRequestMessage-Klasse.
HttpRequestMessage(HttpMethod, Uri)

Initialisiert eine neue instance der HttpRequestMessage-Klasse mit einer HTTP-Methode und einem Anforderungs-URI.

Eigenschaften

Content

Ruft den HTTP-Inhalt ab, der an den Server im HttpRequestMessage-Objekt gesendet werden soll, oder legt diesen fest.
Headers

Ruft die Auflistung der HTTP-Anforderungsheader ab, die der HttpRequestMessage zugeordnet sind.
Method

Ruft die HTTP-Methode ab, die für den Anforderungs-URI ausgeführt werden soll, oder legt diese fest.
PrivacyAnnotation

Stellt eine HTTP-Anforderungsnachricht einschließlich Headern dar.
Properties

Ruft eine Reihe von Eigenschaften für die HttpRequestMessage-instance ab, die vom Entwickler verwendet werden können.
RequestUri

Ruft den URI ab, der für das HttpRequestMessage-Objekt verwendet wird, oder legt den URI fest.
TransportInformation

Ruft Informationen über den zugrunde liegenden Transportsocket ab, der von einer HTTP-Verbindung verwendet wird.

Methoden

Close()

Schließt die httpRequestMessage-instance und gibt zugeordnete Ressourcen frei.
Dispose()

Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.
ToString()

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

Gilt für:

Weitere Informationen