HttpRequestMessage Clase

Definición

Espacio de nombres:

Windows.Web.Http

Representa un mensaje de solicitud HTTP que incluye encabezados.

public ref class HttpRequestMessage sealed : 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.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

Herencia

Object Platform::Object IInspectable HttpRequestMessage

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementaciones

IClosable IDisposable IStringable

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

La clase HttpRequestMessage contiene encabezados, el verbo HTTP y los datos potenciales. Normalmente, los desarrolladores usan esta clase que necesitan control adicional sobre las solicitudes HTTP. Entre los ejemplos comunes se incluyen los siguientes:

• Para examinar la información de transporte SSL/TLS subyacente.
• Para usar un método HTTP menos común.
• Para establecer explícitamente las propiedades de solicitud en HttpRequestMessage.

En estos casos, una aplicación usa uno de los constructores HttpRequestMessage para crear una instancia de HttpRequestMessage. La aplicación establece varias propiedades en HttpRequestMessage según sea necesario. A continuación, httpRequestMessage se pasa como parámetro a uno de los métodos HttpClient.SendRequestAsync .

Varios métodos útiles en la clase HttpClient crean automáticamente un objeto HttpRequestMessage para la aplicación. Estos métodos incluyen lo siguiente:

• DeleteAsync.
• Los métodos GetAsync .
• GetBufferAsync.
• GetInputStreamAsync.
• GetStringAsync.
• PostAsync.
• PutAsync.

Los filtros que agregue a la canalización de filtro se pasarán al objeto HttpRequestMessage si la aplicación especificó explícitamente o se construyó automáticamente.

Constructores

HttpRequestMessage()	Inicializa una nueva instancia de la clase HttpRequestMessage .
HttpRequestMessage(HttpMethod, Uri)	Inicializa una nueva instancia de la clase HttpRequestMessage con un método HTTP y un URI de solicitud.

Propiedades

Content	Obtiene o establece el contenido HTTP que se va a enviar al servidor en el objeto HttpRequestMessage .
Headers	Obtiene la colección de los encabezados de solicitud HTTP asociados a HttpRequestMessage.
Method	Obtiene o establece el método HTTP que se va a realizar en el URI de solicitud.
PrivacyAnnotation	Representa un mensaje de solicitud HTTP que incluye encabezados.
Properties	Obtiene un conjunto de propiedades en la instancia httpRequestMessage que el desarrollador usa.
RequestUri	Obtiene o establece el URI utilizado para el objeto HttpRequestMessage .
TransportInformation	Obtenga información sobre el socket de transporte subyacente utilizado por una conexión HTTP.

Métodos

Close()	Cierra la instancia httpRequestMessage y libera los recursos asignados.
Dispose()	Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados.
ToString()	Devuelve una cadena que representa el objeto HttpRequestMessage actual.

Consulte también

• HttpClient
• IClosable
• IStringable