Teilen über


HttpRequestMessageProperty Klasse

Definition

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::IMessageProperty
public ref class HttpRequestMessageProperty sealed : System::ServiceModel::Channels::IMergeEnabledMessageProperty, System::ServiceModel::Channels::IMessageProperty
public ref class HttpRequestMessageProperty sealed
public sealed class HttpRequestMessageProperty : System.ServiceModel.Channels.IMessageProperty
public sealed class HttpRequestMessageProperty : System.ServiceModel.Channels.IMergeEnabledMessageProperty, System.ServiceModel.Channels.IMessageProperty
public sealed class HttpRequestMessageProperty
type HttpRequestMessageProperty = class
    interface IMessageProperty
type HttpRequestMessageProperty = class
    interface IMessageProperty
    interface IMergeEnabledMessageProperty
type HttpRequestMessageProperty = class
Public NotInheritable Class HttpRequestMessageProperty
Implements IMessageProperty
Public NotInheritable Class HttpRequestMessageProperty
Implements IMergeEnabledMessageProperty, IMessageProperty
Public NotInheritable Class HttpRequestMessageProperty
Vererbung
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:

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.

Gilt für: