HttpRequestMessage Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Web.Http

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

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: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni: IClosable IDisposable IStringable

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