HttpRequestMessage Klasse

Referenz

Definition

Namespace:: Windows.Web.Http

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.

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: