Partilhar via


HttpRequestMessageProperty Classe

Definição

Fornece acesso à solicitação HTTP para acessar e responder às informações adicionais disponibilizadas para solicitações por meio do protocolo HTTP.

public ref class HttpRequestMessageProperty sealed : System::ServiceModel::Channels::IMessageProperty
public ref class HttpRequestMessageProperty sealed : System::ServiceModel::Channels::IMergeEnabledMessageProperty, System::ServiceModel::Channels::IMessageProperty
public ref class HttpRequestMessageProperty sealed
public sealed class HttpRequestMessageProperty : System.ServiceModel.Channels.IMessageProperty
public sealed class HttpRequestMessageProperty : System.ServiceModel.Channels.IMergeEnabledMessageProperty, System.ServiceModel.Channels.IMessageProperty
public sealed class HttpRequestMessageProperty
type HttpRequestMessageProperty = class
    interface IMessageProperty
type HttpRequestMessageProperty = class
    interface IMessageProperty
    interface IMergeEnabledMessageProperty
type HttpRequestMessageProperty = class
Public NotInheritable Class HttpRequestMessageProperty
Implements IMessageProperty
Public NotInheritable Class HttpRequestMessageProperty
Implements IMergeEnabledMessageProperty, IMessageProperty
Public NotInheritable Class HttpRequestMessageProperty
Herança
HttpRequestMessageProperty
Implementações
IMessageProperty System.ServiceModel.Channels.IMergeEnabledMessageProperty

Exemplos

O código a seguir mostra como definir várias das propriedades em uma instância dessa classe e incorporar a instância em uma mensagem.

static Message BuildMessage()
{
    Message messageToSend = null;
    HttpRequestMessageProperty reqProps = new HttpRequestMessageProperty();
    reqProps.SuppressEntityBody = false;
    reqProps.Headers.Add("CustomHeader", "Test Value");
    reqProps.Headers.Add(HttpRequestHeader.UserAgent, "my user agent");

    try
    {
        messageToSend = Message.CreateMessage(MessageVersion.Soap11, "http://tempuri.org/IUntypedService/ProcessMessage", "Hello WCF");
    }
    catch (Exception e)
    {
        Console.WriteLine("got exception when sending message: " + e.ToString());
    }

    messageToSend.Properties[HttpRequestMessageProperty.Name] = reqProps;
    return messageToSend;
}
Private Shared Function BuildMessage() As Message
    Dim messageToSend As Message = Nothing
    Dim reqProps As New HttpRequestMessageProperty()
    reqProps.SuppressEntityBody = False
    reqProps.Headers.Add("CustomHeader", "Test Value")
    reqProps.Headers.Add(HttpRequestHeader.UserAgent, "my user agent")

    Try
        messageToSend = Message.CreateMessage(MessageVersion.Soap11, "http://tempuri.org/IUntypedService/ProcessMessage", "Hello WCF")
    Catch e As Exception
        Console.WriteLine("got exception when sending message: " & e.ToString())
    End Try

    messageToSend.Properties(HttpRequestMessageProperty.Name) = reqProps
    Return messageToSend
End Function

Comentários

Essa é uma classe de uso geral que fornece ao desenvolvedor acesso direto às informações de solicitação HTTP, que podem ser usadas para encapsular informações específicas de HTTP. Um exemplo do uso dessa classe é dar suporte aos serviços implementados de acordo com a arquitetura rest (Transferência de Estado Representacional).

Essa classe habilita o suporte para os seguintes cenários:

  • Varia o verbo HTTP usado para cada solicitação.

  • Permite que pares de cabeçalho HTTP (chave, valor) sejam definidos e consultados por solicitação.

  • Permite que a cadeia de caracteres de consulta seja especificada para uma solicitação HTTP.

Essa classe pode ser usada por HttpTransportBindingElement classes relacionadas e .

Para mensagens de entrada, essa propriedade é adicionada às mensagens.

Para mensagens de saída, essa propriedade faz com que o seguinte aconteça:

Construtores

HttpRequestMessageProperty()

Inicializa uma nova instância da classe HttpRequestMessageProperty.

Propriedades

Headers

Obtém os cabeçalhos HTTP da solicitação HTTP.

HttpRequestMessage

Fornece acesso à solicitação HTTP para acessar e responder às informações adicionais disponibilizadas para solicitações por meio do protocolo HTTP.

Method

Obtém ou define o verbo HTTP para a solicitação HTTP.

Name

Obtém o nome da propriedade de mensagem associado à classe HttpRequestMessageProperty.

QueryString

Obtém ou define a cadeia de caracteres de consulta para a solicitação HTTP.

SuppressEntityBody

Obtém ou define um valor que indica se o corpo da mensagem é ignorado e somente os cabeçalhos são enviados.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Implantações explícitas de interface

IMergeEnabledMessageProperty.TryMergeWithProperty(Object)

Fornece acesso à solicitação HTTP para acessar e responder às informações adicionais disponibilizadas para solicitações por meio do protocolo HTTP.

IMessageProperty.CreateCopy()

Cria e retorna uma cópia do objeto atual.

Aplica-se a