HttpRequestMessageProperty Kelas

Definisi

Ruang nama:

System.ServiceModel.Channels

Rakitan:

System.ServiceModel.Http.dll

Paket:

System.ServiceModel.Http v8.0.0

Sumber:

HttpRequestMessageProperty.cs

Menyediakan akses ke permintaan HTTP untuk mengakses dan merespons informasi tambahan yang tersedia untuk permintaan melalui protokol HTTP.

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

Warisan

Object

HttpRequestMessageProperty

Penerapan

IMessageProperty System.ServiceModel.Channels.IMergeEnabledMessageProperty

Contoh

Kode berikut menunjukkan cara mengatur beberapa properti dalam instans kelas ini dan memasukkan instans ke dalam pesan.

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

Keterangan

Ini adalah kelas tujuan umum yang memberi pengembang akses langsung ke informasi permintaan HTTP, yang dapat digunakan untuk merangkum informasi khusus HTTP. Salah satu contoh penggunaan kelas ini adalah untuk mendukung layanan yang diterapkan sesuai dengan arsitektur Representational State Transfer (REST).

Kelas ini memungkinkan dukungan untuk skenario berikut:

• Bervariasi kata kerja HTTP yang digunakan untuk setiap permintaan.

• Memungkinkan pasangan header HTTP (kunci, nilai) diatur dan dikueri oleh permintaan.

• Memungkinkan string kueri ditentukan untuk permintaan HTTP.

Kelas ini dapat digunakan oleh HttpTransportBindingElement dan kelas terkait.

Untuk pesan masuk, properti ini ditambahkan ke pesan.

Untuk pesan keluar, properti ini menyebabkan hal berikut terjadi:

• Method diatur ke Method.

• QueryString ditambahkan ke RequestUri.

• Headers ditambahkan ke header HTTP yang diatur untuk dikirimkan.

Konstruktor

HttpRequestMessageProperty()

Menginisialisasi instans baru kelas HttpRequestMessageProperty.

Properti

Headers	Mendapatkan header HTTP dari permintaan HTTP.
HttpRequestMessage	Menyediakan akses ke permintaan HTTP untuk mengakses dan merespons informasi tambahan yang tersedia untuk permintaan melalui protokol HTTP.
Method	Mendapatkan atau mengatur kata kerja HTTP untuk permintaan HTTP.
Name	Mendapatkan nama properti pesan yang terkait dengan HttpRequestMessageProperty kelas .
QueryString	Mendapatkan atau mengatur string kueri untuk permintaan HTTP.
SuppressEntityBody	Mendapatkan atau mengatur nilai yang menunjukkan apakah isi pesan diabaikan dan hanya header yang dikirim.

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Implementasi Antarmuka Eksplisit

IMergeEnabledMessageProperty.TryMergeWithProperty(Object)	Menyediakan akses ke permintaan HTTP untuk mengakses dan merespons informasi tambahan yang tersedia untuk permintaan melalui protokol HTTP.
IMessageProperty.CreateCopy()	Membuat dan mengembalikan salinan objek saat ini.