HttpRequestMessageProperty Klas

Definitie

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

Overname

Object

HttpRequestMessageProperty

Implementeringen

IMessageProperty

Voorbeelden

De volgende code laat zien hoe u verschillende eigenschappen in een exemplaar van deze klasse instelt en het exemplaar in een bericht opneemt.

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

Opmerkingen

Dit is een klasse voor algemeen gebruik die de ontwikkelaar directe toegang geeft tot de HTTP-aanvraaggegevens, die kan worden gebruikt voor het inkapselen van HTTP-specifieke informatie. Een voorbeeld van het gebruik van deze klasse is het ondersteunen van services die zijn geïmplementeerd in overeenstemming met de REST-architectuur (Representational State Transfer).

Deze klasse biedt ondersteuning voor de volgende scenario's:

• Varieert het HTTP-werkwoord dat voor elke aanvraag wordt gebruikt.

• Hiermee kunnen HTTP-headerparen (sleutel, waardeparen) worden ingesteld en opgevraagd op aanvraag.

• Hiermee kan de querytekenreeks worden opgegeven voor een HTTP-aanvraag.

Deze klasse kan worden gebruikt door HttpTransportBindingElement en gerelateerde klassen.

Voor binnenkomende berichten wordt deze eigenschap toegevoegd aan berichten.

Voor uitgaande berichten zorgt deze eigenschap ervoor dat het volgende gebeurt:

• Method is ingesteld op Method.

• QueryString wordt toegevoegd aan de RequestUri.

• Headers wordt toegevoegd aan de HTTP-headers die moeten worden verzonden.