HttpRequestMessageProperty.Headers Eigenschaft

Definition

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Http.dll

Assembly:

System.ServiceModel.dll

Ruft die HTTP-Header aus der HTTP-Anforderung ab.

public:
 property System::Net::WebHeaderCollection ^ Headers { System::Net::WebHeaderCollection ^ get(); };

public System.Net.WebHeaderCollection Headers { get; }

member this.Headers : System.Net.WebHeaderCollection

Public ReadOnly Property Headers As WebHeaderCollection

Eigenschaftswert

WebHeaderCollection

Gibt einen WebHeaderCollection zurück, der die HTTP-Header in der HTTP-Anforderung enthält.

Beispiele

Der folgende Code zeigt, wie diese Eigenschaft verwendet wird, um einer Nachricht benutzerdefinierte Header hinzuzufügen.

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

Hier handelt es sich um Situationen, in denen diese Eigenschaft nicht verfügbar ist. Der versuchte Zugriff darauf löst möglicherweise eine Ausnahme aus. Dies kann passieren, wenn WCF in IIS gehostet wird, nachdem die HTTP-Anforderung abgeschlossen ist, insbesondere in One-Way-Szenarien, in denen die Antwort zurückgesendet wird, bevor die Nachricht verfügbar ist.