Condividi tramite


HttpRequestMessage Classe

Definizione

Rappresenta un messaggio di richiesta HTTP, incluse le intestazioni.

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
Ereditarietà
Object Platform::Object IInspectable HttpRequestMessage
Attributi
Implementazioni

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

La classe HttpRequestMessage contiene intestazioni, verbo HTTP e potenzialmente dati. Questa classe viene comunemente usata dagli sviluppatori che necessitano di un controllo aggiuntivo sulle richieste HTTP. Gli esempi comuni includono i seguenti:

  • Per esaminare le informazioni di trasporto SSL/TLS sottostanti.
  • Per usare un metodo HTTP meno comune.
  • Per impostare in modo esplicito le proprietà della richiesta in HttpRequestMessage.

In questi casi, un'app usa uno dei costruttori HttpRequestMessage per creare un'istanza HttpRequestMessage. L'app imposta varie proprietà in HttpRequestMessage in base alle esigenze. Viene quindi passato HttpRequestMessage come parametro a uno dei metodi HttpClient.SendRequestAsync .

Una serie di metodi pratici nella classe HttpClient crea automaticamente un oggetto HttpRequestMessage per l'app. Questi metodi includono quanto segue:

Tutti i filtri aggiunti alla pipeline di filtro verranno passati all'oggetto HttpRequestMessage, indipendentemente dal fatto che sia stato specificato in modo esplicito dall'app o sia stato creato automaticamente.

Costruttori

HttpRequestMessage()

Inizializza una nuova istanza della classe HttpRequestMessage .

HttpRequestMessage(HttpMethod, Uri)

Inizializza una nuova istanza della classe HttpRequestMessage con un metodo HTTP e un URI della richiesta.

Proprietà

Content

Ottiene o imposta il contenuto HTTP da inviare al server nell'oggetto HttpRequestMessage .

Headers

Ottiene la raccolta delle intestazioni di richiesta HTTP associate a HttpRequestMessage.

Method

Ottiene o imposta il metodo HTTP da eseguire sull'URI della richiesta.

PrivacyAnnotation

Rappresenta un messaggio di richiesta HTTP, incluse le intestazioni.

Properties

Ottiene un set di proprietà nell'istanza HttpRequestMessage che vengono usate dallo sviluppatore.

RequestUri

Ottiene o imposta l'URI utilizzato per l'oggetto HttpRequestMessage .

TransportInformation

Ottenere informazioni sul socket di trasporto sottostante utilizzato da una connessione HTTP.

Metodi

Close()

Chiude l'istanza HttpRequestMessage e rilascia le risorse allocate.

Dispose()

Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite.

ToString()

Restituisce una stringa che rappresenta l'oggetto HttpRequestMessage corrente.

Si applica a

Vedi anche