HttpRequestMessage Clase

  • Referencia

Definición

Espacio de nombres:
Windows.Web.Http
Editar

Representa un mensaje de solicitud HTTP que incluye encabezados.

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
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:

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.

Se aplica a

Consulte también