HttpRequestMessageProperty Classe

Definizione

Fornisce accesso alla richiesta HTTP per accedere e rispondere alle informazioni aggiuntive rese disponibili per le richieste sul protocollo HTTP.Provides access to the HTTP request to access and respond to the additional information made available for requests over the HTTP protocol.

public ref class HttpRequestMessageProperty sealed : System::ServiceModel::Channels::IMessageProperty
public ref class HttpRequestMessageProperty sealed
public sealed class HttpRequestMessageProperty : System.ServiceModel.Channels.IMessageProperty
public sealed class HttpRequestMessageProperty
type HttpRequestMessageProperty = class
    interface IMessageProperty
type HttpRequestMessageProperty = class
Public NotInheritable Class HttpRequestMessageProperty
Implements IMessageProperty
Public NotInheritable Class HttpRequestMessageProperty
Ereditarietà
HttpRequestMessageProperty
Implementazioni

Esempio

Il seguente codice mostra come impostare numerose proprietà in un'istanza di questa classe e incorporarle in un messaggio.The following code shows how to set several of the properties in an instance of this class and incorporate the instance into a message.

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

Commenti

Si tratta di una classe di utilizzo generale che consente allo sviluppatore di accedere direttamente alle informazioni sulla richiesta HTTP che possono essere utilizzate per incapsulare informazioni specifiche per HTTP.This is a general-purpose class that gives the developer direct access to the HTTP request information, which can be used for encapsulating HTTP-specific information. Questa classe viene ad esempio utilizzata per supportare i servizi implementati in conformità con l'architettura Representational State Transfer (REST).One example of the use of this class is to support services implemented in accordance with the Representational State Transfer (REST) architecture.

Questa classe attiva il supporto per gli scenari seguenti:This class enables support for the following scenarios:

  • Varia il verbo HTTP utilizzato per ogni richiesta.Varies the HTTP verb used for each request.

  • Consente di impostare coppie di intestazioni HTTP (chiave, valore) e di eseguire query su richiesta.Allows HTTP header (key, value) pairs to be set and queried by request.

  • Consente di specificare la stringa di query per una richiesta HTTP.Allows the query string to be specified for an HTTP request.

Questa classe può essere utilizzata da HttpTransportBindingElement e dalle classi correlate.This class can be used by HttpTransportBindingElement and related classes.

Per i messaggi in arrivo, questa proprietà viene aggiunta ai messaggi.For incoming messages, this property is added to messages.

Per i messaggi in uscita, questa proprietà fa sì che si verifichi quanto segue:For outgoing messages, this property causes the following to happen:

Costruttori

HttpRequestMessageProperty()

Inizializza una nuova istanza della classe HttpRequestMessageProperty.Initializes a new instance of the HttpRequestMessageProperty class.

Proprietà

Headers

Ottiene le intestazioni HTTP dalla richiesta HTTP.Gets the HTTP headers from the HTTP request.

Method

Ottiene o imposta il verbo HTTP per la richiesta HTTP.Gets or sets the HTTP verb for the HTTP request.

Name

Ottiene il nome della proprietà del messaggio associata alla classe HttpRequestMessageProperty.Gets the name of the message property associated with the HttpRequestMessageProperty class.

QueryString

Ottiene o imposta la stringa di query per la richiesta HTTP.Gets or sets the query string for the HTTP request.

SuppressEntityBody

Ottiene o imposta un valore che indica se il corpo del messaggio viene ignorato e se vengono inviate solo le intestazioni.Gets or sets a value that indicates whether the body of the message is ignored and only the headers are sent.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

IMessageProperty.CreateCopy()

Crea e restituisce una copia dell'oggetto corrente.Creates and returns a copy of the current object.

Si applica a