HttpRequestMessageProperty.Headers Propriété

Définition

Espace de noms:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Http.dll

Paquet:

System.ServiceModel.Http v8.0.0

Source:

HttpRequestMessageProperty.cs

Obtient les en-têtes HTTP de la requête HTTP.

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

Valeur de propriété

WebHeaderCollection

Retourne une WebHeaderCollection qui contient les en-têtes HTTP dans la requête HTTP.

Exemples

Le code suivant montre comment utiliser cette propriété pour ajouter des en-têtes personnalisés à un message.

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

Remarques

Il est possible que l'accès à cette propriété, si celle-ci n'est pas disponible, entraîne dans certains cas une exception. Cela peut se produire lorsque WCF est hébergé dans IIS, une fois la requête HTTP terminée, en particulier dans les scénarios unidirectionnel où la réponse est renvoyée avant que le message ne soit disponible.