HttpRequestMessageProperty.Headers Eigenschaft

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

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

Beispiele

Der folgende Code zeigt, wie Sie diese Eigenschaft verwenden, um einer Nachricht benutzerdefinierte Kopfzeilen 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

Es gibt Situationen, in denen diese Eigenschaft nicht verfügbar ist, und der Versuch, darauf zuzugreifen, eine Ausnahme verursachen kann. Dies kann passieren, wenn WCF in IIS gehostet wird, nachdem die HTTP-Anforderung abgeschlossen ist, insbesondere in Unidirektionalszenarien, in denen die Antwort zurückgesendet wird, bevor die Nachricht verfügbar ist.