HttpRequestMessageProperty Klasa

Definicja

Przestrzeń nazw:

System.ServiceModel.Channels

Zestaw:

System.ServiceModel.Http.dll

Pakiet:

System.ServiceModel.Http v6.2.0

Źródło:

HttpRequestMessageProperty.cs

Zapewnia dostęp do żądania HTTP w celu uzyskania dostępu do dodatkowych informacji udostępnianych dla żądań za pośrednictwem protokołu HTTP i odpowiadania na nie.

public ref class HttpRequestMessageProperty sealed : System::ServiceModel::Channels::IMessageProperty

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

type HttpRequestMessageProperty = class
    interface IMessageProperty

Public NotInheritable Class HttpRequestMessageProperty
Implements IMessageProperty

Dziedziczenie

Object

HttpRequestMessageProperty

Implementuje

IMessageProperty

Przykłady

Poniższy kod pokazuje, jak ustawić kilka właściwości w wystąpieniu tej klasy i dołączyć wystąpienie do komunikatu.

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

Uwagi

Jest to klasa ogólnego przeznaczenia, która zapewnia deweloperowi bezpośredni dostęp do informacji o żądaniu HTTP, które mogą służyć do hermetyzacji informacji specyficznych dla protokołu HTTP. Przykładem użycia tej klasy jest obsługa usług wdrożonych zgodnie z architekturą Representational State Transfer (REST).

Ta klasa umożliwia obsługę następujących scenariuszy:

• Zmienia czasownik HTTP używany dla każdego żądania.

• Umożliwia ustawianie par nagłówka HTTP (klucz, wartość) i wykonywanie zapytań przez żądanie.

• Umożliwia określenie ciągu zapytania dla żądania HTTP.

Ta klasa może być używana przez HttpTransportBindingElement klasy pokrewne i .

W przypadku komunikatów przychodzących ta właściwość jest dodawana do komunikatów.

W przypadku komunikatów wychodzących ta właściwość powoduje wystąpienie następujących przyczyn:

• Method parametr jest ustawiony na Methodwartość .

• QueryString element jest dołączany do pliku RequestUri.

• Headers jest dodawany do nagłówków HTTP ustawionych do przesyłania.

Konstruktory

HttpRequestMessageProperty()

Inicjuje nowe wystąpienie klasy HttpRequestMessageProperty.

Właściwości

Headers	Pobiera nagłówki HTTP z żądania HTTP.
HttpRequestMessage	Zapewnia dostęp do żądania HTTP w celu uzyskania dostępu do dodatkowych informacji udostępnianych dla żądań za pośrednictwem protokołu HTTP i odpowiadania na nie.
Method	Pobiera lub ustawia czasownik HTTP dla żądania HTTP.
Name	Pobiera nazwę właściwości komunikatu skojarzonej z klasą HttpRequestMessageProperty .
QueryString	Pobiera lub ustawia ciąg zapytania dla żądania HTTP.
SuppressEntityBody	Pobiera lub ustawia wartość wskazującą, czy treść wiadomości jest ignorowana i wysyłane są tylko nagłówki.

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

IMessageProperty.CreateCopy()

Tworzy i zwraca kopię bieżącego obiektu.