Aracılığıyla paylaş


HttpRequestMessageProperty Sınıf

Tanım

HTTP protokolü üzerinden istekler için sağlanan ek bilgilere erişmek ve bu bilgileri yanıtlamak için HTTP isteğine erişim sağlar.

public ref class HttpRequestMessageProperty sealed : System::ServiceModel::Channels::IMessageProperty
public ref class HttpRequestMessageProperty sealed : System::ServiceModel::Channels::IMergeEnabledMessageProperty, System::ServiceModel::Channels::IMessageProperty
public ref class HttpRequestMessageProperty sealed
public sealed class HttpRequestMessageProperty : System.ServiceModel.Channels.IMessageProperty
public sealed class HttpRequestMessageProperty : System.ServiceModel.Channels.IMergeEnabledMessageProperty, System.ServiceModel.Channels.IMessageProperty
public sealed class HttpRequestMessageProperty
type HttpRequestMessageProperty = class
    interface IMessageProperty
type HttpRequestMessageProperty = class
    interface IMessageProperty
    interface IMergeEnabledMessageProperty
type HttpRequestMessageProperty = class
Public NotInheritable Class HttpRequestMessageProperty
Implements IMessageProperty
Public NotInheritable Class HttpRequestMessageProperty
Implements IMergeEnabledMessageProperty, IMessageProperty
Public NotInheritable Class HttpRequestMessageProperty
Devralma
HttpRequestMessageProperty
Uygulamalar
IMessageProperty System.ServiceModel.Channels.IMergeEnabledMessageProperty

Örnekler

Aşağıdaki kodda, bu sınıfın bir örneğindeki özelliklerin birkaçının nasıl ayarlanacağı ve örneğin iletiye nasıl eklanacağı gösterilmektedir.

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

Açıklamalar

Bu, geliştiriciye HTTP'ye özgü bilgileri kapsüllemek için kullanılabilecek HTTP isteği bilgilerine doğrudan erişim sağlayan genel amaçlı bir sınıftır. Bu sınıfın kullanımına bir örnek, Temsili Durum Aktarımı (REST) mimarisine uygun olarak uygulanan hizmetleri desteklemektir.

Bu sınıf aşağıdaki senaryolar için destek sağlar:

  • Her istek için kullanılan HTTP fiilini değişir.

  • HTTP üst bilgisi (anahtar, değer) çiftlerinin istek tarafından ayarlanmasına ve sorgulanmasına izin verir.

  • Sorgu dizesinin bir HTTP isteği için belirtilmesine izin verir.

Bu sınıf ve ilgili sınıflar tarafından HttpTransportBindingElement kullanılabilir.

Gelen iletiler için bu özellik iletilere eklenir.

Giden iletiler için bu özellik aşağıdakilerin gerçekleşmesine neden olur:

Oluşturucular

HttpRequestMessageProperty()

HttpRequestMessageProperty sınıfının yeni bir örneğini başlatır.

Özellikler

Headers

HTTP isteğinden HTTP üst bilgilerini alır.

HttpRequestMessage

HTTP protokolü üzerinden istekler için sağlanan ek bilgilere erişmek ve bu bilgileri yanıtlamak için HTTP isteğine erişim sağlar.

Method

HTTP isteğinin HTTP fiilini alır veya ayarlar.

Name

sınıfıyla ilişkili ileti özelliğinin HttpRequestMessageProperty adını alır.

QueryString

HTTP isteği için sorgu dizesini alır veya ayarlar.

SuppressEntityBody

İleti gövdesinin yoksayıldığını ve yalnızca üst bilgilerin gönderilip gönderilmediğini belirten bir değer alır veya ayarlar.

Yöntemler

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

IMergeEnabledMessageProperty.TryMergeWithProperty(Object)

HTTP protokolü üzerinden istekler için sağlanan ek bilgilere erişmek ve bu bilgileri yanıtlamak için HTTP isteğine erişim sağlar.

IMessageProperty.CreateCopy()

Geçerli nesnenin bir kopyasını oluşturur ve döndürür.

Şunlara uygulanır