HttpRequestMessageProperty.Headers 屬性

定義

命名空間:

System.ServiceModel.Channels

組件:

System.ServiceModel.Http.dll

套件:

System.ServiceModel.Http v6.2.0

來源:

HttpRequestMessageProperty.cs

從 HTTP 要求取得 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

屬性值

WebHeaderCollection

傳回 WebHeaderCollection，其中包含 HTTP 要求內的 HTTP 標頭。

範例

下列程式碼會示範如何使用這個屬性，將自訂標頭加入至訊息中。

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

備註

某些狀況下，無法使用這個屬性，而且嘗試存取它可能會造成例外狀況。 當 WCF 裝載于 IIS 時，當 HTTP 要求完成之後，就會發生這種情況，特別是在訊息可供使用之前傳回回複的單向案例中。