HttpRequestMessageProperty Sınıf

Tanım

Ad Alanı:

System.ServiceModel.Channels

Bütünleştirilmiş Kod:

System.ServiceModel.Http.dll

Paket:

System.ServiceModel.Http v8.0.0

Kaynak:

HttpRequestMessageProperty.cs

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::IMergeEnabledMessageProperty, System::ServiceModel::Channels::IMessageProperty

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

type HttpRequestMessageProperty = class
    interface IMessageProperty
    interface IMergeEnabledMessageProperty

Public NotInheritable Class HttpRequestMessageProperty
Implements IMergeEnabledMessageProperty, IMessageProperty

Devralma

Object

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:

• Method olarak ayarlanır Method.

• QueryString öğesine eklenir RequestUri.

• Headers aktarılacak şekilde ayarlanan HTTP üst bilgilerine eklenir.

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.