Bagikan melalui


HttpRequestMessageProperty Kelas

Definisi

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::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
Warisan
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:

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.

Berlaku untuk