Partager via


HttpRequestMessage Classe

Définition

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
Implémente

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 à

Voir aussi