HttpRequestMessage Classe

Référence

Définition

Espace de noms:: Windows.Web.Http

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Représente un message de requête HTTP incluant des en-têtes.

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

Héritage: Object Platform::Object IInspectable HttpRequestMessage

Attributs: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implémente: IClosable IDisposable IStringable

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

La classe HttpRequestMessage contient des en-têtes, le verbe HTTP et potentiellement des données. Cette classe est couramment utilisée par les développeurs qui ont besoin d’un contrôle supplémentaire sur les requêtes HTTP. Voici quelques exemples courants :

Pour examiner les informations de transport SSL/TLS sous-jacentes.
Pour utiliser une méthode HTTP moins courante.
Pour définir explicitement les propriétés de requête sur httpRequestMessage.

Dans ce cas, une application utilise l’un des constructeurs HttpRequestMessage pour créer un instance HttpRequestMessage. L’application définit différentes propriétés sur httpRequestMessage en fonction des besoins. HttpRequestMessage est ensuite passé en tant que paramètre à l’une des méthodes HttpClient.SendRequestAsync .

Un certain nombre de méthodes pratiques sur la classe HttpClient créent automatiquement un objet HttpRequestMessage pour l’application. Ces méthodes sont les suivantes :

Tous les filtres que vous ajoutez au pipeline de filtre seront transmis à l’objet HttpRequestMessage, qu’il ait été explicitement spécifié par l’application ou qu’il ait été construit automatiquement pour vous.

Constructeurs

HttpRequestMessage()	Initialise une nouvelle instance de la classe HttpRequestMessage.
HttpRequestMessage(HttpMethod, Uri)	Initialise une nouvelle instance de la classe HttpRequestMessage avec une méthode HTTP et un URI de requête.

Propriétés

Content	Obtient ou définit le contenu HTTP à envoyer au serveur sur l’objet HttpRequestMessage .
Headers	Obtient la collection des en-têtes de requête HTTP associés à HttpRequestMessage.
Method	Obtient ou définit la méthode HTTP à exécuter sur l’URI de requête.
PrivacyAnnotation	Représente un message de requête HTTP incluant des en-têtes.
Properties	Obtient un ensemble de propriétés sur le instance HttpRequestMessage qui sont destinées à être utilisées par le développeur.
RequestUri	Obtient ou définit l’URI utilisé pour l’objet HttpRequestMessage .
TransportInformation	Obtenez des informations sur le socket de transport sous-jacent utilisé par une connexion HTTP.

Méthodes

Close()	Ferme le instance HttpRequestMessage et libère les ressources allouées.
Dispose()	Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées.
ToString()	Renvoie une chaîne qui représente l’objet HttpRequestMessage actuel.

S’applique à