HttpRequestMessageProperty Classe

Definição

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Http.dll

Pacote:

System.ServiceModel.Http v8.0.0

Origem:

HttpRequestMessageProperty.cs

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::IMergeEnabledMessageProperty, System::ServiceModel::Channels::IMessageProperty

public sealed class HttpRequestMessageProperty : System.ServiceModel.Channels.IMergeEnabledMessageProperty, System.ServiceModel.Channels.IMessageProperty

type HttpRequestMessageProperty = class
    interface IMessageProperty
    interface IMergeEnabledMessageProperty

Public NotInheritable Class HttpRequestMessageProperty
Implements IMergeEnabledMessageProperty, IMessageProperty

Herança

Object

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:

• Method é definido como Method.

• QueryString é acrescentado ao RequestUri.

• Headers é adicionado aos cabeçalhos HTTP definidos para serem transmitidos.

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.