HttpRequestMessageProperty Třída

Definice

Obor názvů:

System.ServiceModel.Channels

Sestavení:

System.ServiceModel.Http.dll

Balíček:

System.ServiceModel.Http v8.0.0

Zdroj:

HttpRequestMessageProperty.cs

Poskytuje přístup k požadavku HTTP pro přístup a reakci na další informace dostupné pro požadavky přes protokol 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

Dědičnost

Object

HttpRequestMessageProperty

Implementuje

IMessageProperty System.ServiceModel.Channels.IMergeEnabledMessageProperty

Příklady

Následující kód ukazuje, jak nastavit několik vlastností v instanci této třídy a začlenit instanci do zprávy.

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

Poznámky

Toto je třída pro obecné účely, která poskytuje vývojáři přímý přístup k informacím o požadavcích HTTP, které lze použít k zapouzdření informací specifických pro protokol HTTP. Jedním z příkladů použití této třídy je podpora služeb implementovaných v souladu s architekturou REST (Representational State Transfer).

Tato třída podporuje následující scénáře:

• Liší se příkaz HTTP použitý pro každý požadavek.

• Umožňuje nastavit dvojice hlaviček HTTP (klíč, hodnota) a dotazovat se na základě požadavku.

• Umožňuje zadat řetězec dotazu pro požadavek HTTP.

Tuto třídu mohou používat HttpTransportBindingElement třídy a související třídy.

U příchozích zpráv je tato vlastnost přidána do zpráv.

U odchozích zpráv tato vlastnost způsobí následující:

• Method je nastavená na Methodhodnotu .

• QueryString se připojí k objektu RequestUri.

• Headers se přidá do hlaviček HTTP nastavených pro přenos.

Konstruktory

HttpRequestMessageProperty()

Inicializuje novou instanci HttpRequestMessageProperty třídy.

Vlastnosti

Headers	Získá hlavičky HTTP z požadavku HTTP.
HttpRequestMessage	Poskytuje přístup k požadavku HTTP pro přístup a reakci na další informace dostupné pro požadavky přes protokol HTTP.
Method	Získá nebo nastaví příkaz HTTP pro požadavek HTTP.
Name	Získá název vlastnosti message přidružené k HttpRequestMessageProperty třídě.
QueryString	Získá nebo nastaví řetězec dotazu pro požadavek HTTP.
SuppressEntityBody	Získá nebo nastaví hodnotu, která označuje, zda text zprávy je ignorován a pouze hlavičky jsou odeslány.

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

IMergeEnabledMessageProperty.TryMergeWithProperty(Object)	Poskytuje přístup k požadavku HTTP pro přístup a reakci na další informace dostupné pro požadavky přes protokol HTTP.
IMessageProperty.CreateCopy()	Vytvoří a vrátí kopii aktuálního objektu.