Partilhar via


HttpRequestMessage Classe

Definição

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

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
Herança
Object Platform::Object IInspectable HttpRequestMessage
Atributos
Implementações

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:

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.

Aplica-se a

Confira também