HttpRequestMessage Classe

Definição

Namespace:

Windows.Web.Http

Representa uma mensagem de solicitação HTTP, incluindo cabeçalhos.

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

Herança

Object Platform::Object IInspectable HttpRequestMessage

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

IClosable IDisposable IStringable

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

A classe HttpRequestMessage contém cabeçalhos, o verbo HTTP e, potencialmente, dados. Essa classe é comumente usada por desenvolvedores que precisam de controle adicional sobre solicitações HTTP. Exemplos comuns incluem o seguinte:

• Para examinar as informações de transporte SSL/TLS subjacentes.
• Para usar um método HTTP menos comum.
• Para definir explicitamente as propriedades de solicitação no HttpRequestMessage.

Nesses casos, um aplicativo usa um dos construtores HttpRequestMessage para criar uma instância httpRequestMessage. O aplicativo define várias propriedades no HttpRequestMessage conforme necessário. Em seguida, o HttpRequestMessage é passado como um parâmetro para um dos métodos HttpClient.SendRequestAsync .

Vários métodos de conveniência na classe HttpClient criam automaticamente um objeto HttpRequestMessage para o aplicativo. Esses métodos incluem o seguinte:

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

Todos os filtros que você adicionar ao pipeline de filtro serão passados para o objeto HttpRequestMessage, seja ele especificado explicitamente pelo aplicativo ou se foi construído automaticamente para você.

Construtores

HttpRequestMessage()	Inicializa uma nova instância da classe HttpRequestMessage .
HttpRequestMessage(HttpMethod, Uri)	Inicializa uma nova instância da classe HttpRequestMessage com um método HTTP e um Uri de solicitação.

Propriedades

Content	Obtém ou define o conteúdo HTTP a ser enviado para o servidor no objeto HttpRequestMessage .
Headers	Obtém a coleção dos cabeçalhos de solicitação HTTP associados ao HttpRequestMessage.
Method	Obtém ou define o método HTTP a ser executado no URI de solicitação.
PrivacyAnnotation	Representa uma mensagem de solicitação HTTP, incluindo cabeçalhos.
Properties	Obtém um conjunto de propriedades na instância HttpRequestMessage que são usadas pelo desenvolvedor.
RequestUri	Obtém ou define o Uri usado para o objeto HttpRequestMessage .
TransportInformation	Obtenha informações sobre o soquete de transporte subjacente usado por uma conexão HTTP.

Métodos

Close()	Fecha a instância httpRequestMessage e libera recursos alocados.
Dispose()	Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados.
ToString()	Retorna uma cadeia de caracteres que representa o objeto HttpRequestMessage atual.

Confira também

• HttpClient
• IClosable
• IStringable