HttpRequestMessageProperty 클래스

정의

네임스페이스:

System.ServiceModel.Channels

어셈블리:

System.ServiceModel.Http.dll

어셈블리:

System.ServiceModel.dll

HTTP 프로토콜을 통한 요청이 있을 때 사용할 수 있는 추가 정보에 액세스하고 응답할 수 있도록 HTTP 요청에 대한 액세스를 제공합니다.

public ref class HttpRequestMessageProperty sealed : System::ServiceModel::Channels::IMessageProperty

public ref class HttpRequestMessageProperty sealed

public sealed class HttpRequestMessageProperty : System.ServiceModel.Channels.IMessageProperty

public sealed class HttpRequestMessageProperty

type HttpRequestMessageProperty = class
    interface IMessageProperty

type HttpRequestMessageProperty = class

Public NotInheritable Class HttpRequestMessageProperty
Implements IMessageProperty

Public NotInheritable Class HttpRequestMessageProperty

상속

Object

HttpRequestMessageProperty

구현

IMessageProperty

예제

다음 코드에서는 이 클래스의 인스턴스에서 여러 속성을 설정하고 인스턴스를 메시지에 통합하는 방법을 보여 줍니다.

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

설명

이 클래스는 HTTP 관련 정보를 캡슐화하는 데 사용할 수 있는 HTTP 요청 정보에 대한 직접 액세스 권한을 개발자에게 제공하는 범용 클래스입니다. 이 클래스를 사용하는 한 가지 예는 REST(Representational State Transfer) 아키텍처에 따라 구현된 서비스를 지원하는 것입니다.

이 클래스를 사용하면 다음 시나리오를 지원할 수 있습니다.

• 각 요청에 사용되는 HTTP 동사에 따라 다릅니다.

• 요청에 따라 HTTP 헤더(키, 값) 쌍을 설정하고 쿼리할 수 있습니다.

• HTTP 요청에 대해 쿼리 문자열을 지정할 수 있습니다.

이 클래스는 관련 클래스에서 HttpTransportBindingElement 사용할 수 있습니다.

들어오는 메시지의 경우 이 속성이 메시지에 추가됩니다.

보내는 메시지의 경우 이 속성으로 인해 다음이 발생합니다.

• Method이 Method로 설정됩니다.

• QueryString 가 .에 RequestUri추가됩니다.

• Headers 는 전송되도록 설정된 HTTP 헤더에 추가됩니다.

생성자

HttpRequestMessageProperty()

HttpRequestMessageProperty 클래스의 새 인스턴스를 초기화합니다.

속성

Headers	HTTP 요청에서 HTTP 헤더를 가져옵니다.
Method	HTTP 요청의 HTTP 동사를 가져오거나 설정합니다.
Name	HttpRequestMessageProperty 클래스와 연결된 메시지 속성의 이름을 가져옵니다.
QueryString	HTTP 요청의 쿼리 문자열을 가져오거나 설정합니다.
SuppressEntityBody	메시지 본문을 무시하고 헤더만 보내는지 여부를 나타내는 값을 가져오거나 설정합니다.

메서드

Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)

명시적 인터페이스 구현

IMessageProperty.CreateCopy()

현재 개체의 복사본을 만들어 반환합니다.