HttpRequestMessageProperty Klasse

Definition

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Http.dll

Paket:

System.ServiceModel.Http v8.0.0

Quelle:

HttpRequestMessageProperty.cs

Ermöglicht den Zugriff auf die HTTP-Anforderung, um auf zusätzliche Informationen für Anforderungen zugreifen und reagieren zu können, die über das HTTP-Protokoll verfügbar gemacht werden.

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

Vererbung

Object

HttpRequestMessageProperty

Implementiert

IMessageProperty System.ServiceModel.Channels.IMergeEnabledMessageProperty

Beispiele

Der folgende Code zeigt, wie diverse Eigenschaften in einer Instanz dieser Klasse eingerichtet werden und wie die Instanz in eine Nachricht eingebunden wird.

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

Hinweise

Dabei handelt es sich um eine allgemeine Klasse, die dem Entwickler direkten Zugriff auf die HTTP-Anforderungsinformationen ermöglicht, die zur Einkapselung HTTP-spezifischer Informationen verwendet werden können. Diese Klasse unterstützt u. a. Dienste, die in Übereinstimmung mit der Representational State Transfer (REST)-Architektur implementiert werden.

Diese Klasse ermöglicht die Unterstützung folgender Szenarien:

• Variiert das für jede Anforderung verwendete HTTP-Verb.

• Ermöglicht die Einrichtung von HTTP-Header-Paaren (Schlüssel, Wert) und deren Abfrage auf Anforderung.

• Ermöglicht die Festlegung der Abfragezeichenfolge für eine HTTP-Anforderung.

Diese Klasse kann von HttpTransportBindingElement und verwandten Klassen verwendet werden.

Bei eingehenden Nachrichten wird diese Eigenschaft den Nachrichten hinzugefügt.

Bei ausgehenden Nachrichten veranlasst diese Eigenschaft Folgendes:

• Für Method ist Method festgelegt.

• QueryString wird angehängt an RequestUri.

• Headers wird den zu übertragenden HTTP-Headern hinzugefügt.

Konstruktoren

HttpRequestMessageProperty()

Initialisiert eine neue Instanz der HttpRequestMessageProperty-Klasse.

Eigenschaften

Headers	Ruft die HTTP-Header aus der HTTP-Anforderung ab.
HttpRequestMessage	Ermöglicht den Zugriff auf die HTTP-Anforderung, um auf zusätzliche Informationen für Anforderungen zugreifen und reagieren zu können, die über das HTTP-Protokoll verfügbar gemacht werden.
Method	Ruft das HTTP-Verb für die HTTP-Anforderung ab oder legt dieses fest.
Name	Ruft den Namen der Nachrichteneigenschaft ab, die mit der HttpRequestMessageProperty-Klasse verknüpft ist.
QueryString	Ruft die Abfragezeichenfolge für die HTTP-Anforderung ab oder legt diese fest.
SuppressEntityBody	Ruft einen Wert ab, der angibt, ob der Nachrichtentext ignoriert wird und nur die Header gesendet werden, oder legt diesen fest.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

IMergeEnabledMessageProperty.TryMergeWithProperty(Object)	Ermöglicht den Zugriff auf die HTTP-Anforderung, um auf zusätzliche Informationen für Anforderungen zugreifen und reagieren zu können, die über das HTTP-Protokoll verfügbar gemacht werden.
IMessageProperty.CreateCopy()	Erstellt eine Kopie des aktuellen Objekts und gibt sie zurück.