Message.CreateMessage Metode

Referensi

Definisi

Ruang nama:: System.ServiceModel.Channels

Rakitan:: System.ServiceModel.Primitives.dll

Rakitan:: System.ServiceModel.dll

Paket:: System.ServiceModel.Primitives v6.0.0

Paket:: System.ServiceModel.Primitives v6.2.0

Paket:: System.ServiceModel.Primitives v8.0.0

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Membuat pesan.

Overload

CreateMessage(MessageVersion, FaultCode, String, Object, String)	Membuat pesan yang berisi kesalahan SOAP, alasan dan detail untuk kesalahan, versi, dan tindakan.
CreateMessage(MessageVersion, FaultCode, String, String)	Membuat pesan yang berisi kesalahan SOAP, alasan kesalahan, versi, dan tindakan.
CreateMessage(XmlReader, Int32, MessageVersion)	Membuat pesan menggunakan pembaca, tindakan, dan versi yang ditentukan.
CreateMessage(XmlDictionaryReader, Int32, MessageVersion)	Membuat pesan menggunakan pembaca, tindakan, dan versi yang ditentukan.
CreateMessage(MessageVersion, String, XmlReader)	Membuat pesan menggunakan pembaca, tindakan, dan versi yang ditentukan.
CreateMessage(MessageVersion, String, Object, XmlObjectSerializer)	Membuat pesan menggunakan versi, tindakan, isi pesan, dan serializer yang ditentukan.
CreateMessage(MessageVersion, String, BodyWriter)	Membuat pesan dengan isi yang terdiri dari array byte.
CreateMessage(MessageVersion, String, Object)	Membuat pesan dengan versi, tindakan, dan isi yang ditentukan.
CreateMessage(MessageVersion, MessageFault, String)	Membuat pesan yang berisi kesalahan SOAP, versi, dan tindakan.
CreateMessage(MessageVersion, String, XmlDictionaryReader)	Membuat pesan dengan versi, tindakan, dan isi yang ditentukan.
CreateMessage(MessageVersion, String)	Membuat pesan yang berisi versi dan tindakan.

Contoh

Contoh kode berikut menunjukkan klien yang menggunakan pabrik saluran untuk mengirim pesan dan membaca balasan.

using System;
using System.Collections.Generic;
using System.Text;
using System.ServiceModel;
using System.ServiceModel.Channels;
using System.Runtime.Serialization;

namespace ConsoleApplication1
{
    class client
    {

        static void RunClient()
        {
            //Step1: create a binding with just HTTP
            CustomBinding binding = new CustomBinding();
            binding.Elements.Add(new HttpTransportBindingElement());
            //Step2: use the binding to build the channel factory
            IChannelFactory<IRequestChannel> factory =
            binding.BuildChannelFactory<IRequestChannel>(
                             new BindingParameterCollection());
            //open the channel factory
            factory.Open();
            //Step3: use the channel factory to create a channel
            IRequestChannel channel = factory.CreateChannel(
               new EndpointAddress("http://localhost:8080/channelapp"));
            channel.Open();
            //Step4: create a message
            Message requestmessage = Message.CreateMessage(
                MessageVersion.Soap12WSAddressing10,
                "http://contoso.com/someaction",
                 "This is the body data");
            //send message
            Message replymessage = channel.Request(requestmessage);
            Console.WriteLine("Reply message received");
            Console.WriteLine("Reply action: {0}",
                                  replymessage.Headers.Action);
            string data = replymessage.GetBody<string>();
            Console.WriteLine("Reply content: {0}", data);
            //Step5: don't forget to close the message
            requestmessage.Close();
            replymessage.Close();
            //don't forget to close the channel
            channel.Close();
            //don't forget to close the factory
            factory.Close();
        }
        public static void Main()
        {
            Console.WriteLine("Press [ENTER] when service is ready");
            Console.ReadLine();
            RunClient();
            Console.WriteLine("Press [ENTER] to exit");
            Console.ReadLine();
        }
    }
}



Imports System.Collections.Generic
Imports System.Text
Imports System.ServiceModel
Imports System.ServiceModel.Channels
Imports System.Runtime.Serialization

Namespace ConsoleApplication1
    Friend Class client


        Private Shared Sub RunClient()
            'Step1: create a binding with just HTTP
            Dim binding As New CustomBinding()
            binding.Elements.Add(New HttpTransportBindingElement())
            'Step2: use the binding to build the channel factory
            Dim factory As IChannelFactory(Of IRequestChannel) = binding.BuildChannelFactory(Of IRequestChannel)(New BindingParameterCollection())
            'open the channel factory
            factory.Open()
            'Step3: use the channel factory to create a channel
            Dim channel As IRequestChannel = factory.CreateChannel(New EndpointAddress("http://localhost:8080/channelapp"))
            channel.Open()
            'Step4: create a message
            Dim requestmessage As Message = Message.CreateMessage(MessageVersion.Soap12WSAddressing10, "http://contoso.com/someaction", "This is the body data")
            'send message
            Dim replymessage As Message = channel.Request(requestmessage)
            Console.WriteLine("Reply message received")
            Console.WriteLine("Reply action: {0}", replymessage.Headers.Action)
            Dim data = replymessage.GetBody(Of String)()
            Console.WriteLine("Reply content: {0}", data)
            'Step5: don't forget to close the message
            requestmessage.Close()
            replymessage.Close()
            'don't forget to close the channel
            channel.Close()
            'don't forget to close the factory
            factory.Close()
        End Sub
        Public Shared Sub Main()
            Console.WriteLine("Press [ENTER] when service is ready")
            Console.ReadLine()
            RunClient()
            Console.WriteLine("Press [ENTER] to exit")
            Console.ReadLine()
        End Sub
    End Class
End Namespace

Keterangan

Metode ini digunakan untuk membuat salinan baru pesan yang siap dikirim.

Saat bekerja dengan pesan JSON menggunakan CreateMessage(MessageVersion, String, Object, XmlObjectSerializer) metode , CreateMessage(MessageVersion, String, Object) metode ini tidak berfungsi dengan pesan JSON.

CreateMessage(MessageVersion, FaultCode, String, Object, String)

Sumber:: Message.cs

Sumber:: Message.cs

Sumber:: Message.cs

Membuat pesan yang berisi kesalahan SOAP, alasan dan detail untuk kesalahan, versi, dan tindakan.

public:
 static System::ServiceModel::Channels::Message ^ CreateMessage(System::ServiceModel::Channels::MessageVersion ^ version, System::ServiceModel::FaultCode ^ faultCode, System::String ^ reason, System::Object ^ detail, System::String ^ action);

public static System.ServiceModel.Channels.Message CreateMessage (System.ServiceModel.Channels.MessageVersion version, System.ServiceModel.FaultCode faultCode, string reason, object detail, string action);

static member CreateMessage : System.ServiceModel.Channels.MessageVersion * System.ServiceModel.FaultCode * string * obj * string -> System.ServiceModel.Channels.Message

Public Shared Function CreateMessage (version As MessageVersion, faultCode As FaultCode, reason As String, detail As Object, action As String) As Message

Parameter

version: MessageVersion

Objek MessageVersion yang menentukan versi SOAP yang akan digunakan untuk pesan.

faultCode: FaultCode

Objek MessageFault yang mewakili kesalahan SOAP.

reason: String

Alasan kesalahan SOAP.

detail: Object

Detail kesalahan SOAP.

action: String

Deskripsi tentang bagaimana pesan harus diproses.

Mengembalikan

Message

Objek Message untuk pesan yang dibuat.

Pengecualian

ArgumentNullException

version, fault, action, detail atau faultCode adalah null.

Keterangan

Metode statis ini digunakan untuk membuat salinan pesan baru yang siap dikirim.

Berlaku untuk

CreateMessage(MessageVersion, FaultCode, String, String)

Sumber:: Message.cs

Sumber:: Message.cs

Sumber:: Message.cs

Membuat pesan yang berisi kesalahan SOAP, alasan kesalahan, versi, dan tindakan.

public:
 static System::ServiceModel::Channels::Message ^ CreateMessage(System::ServiceModel::Channels::MessageVersion ^ version, System::ServiceModel::FaultCode ^ faultCode, System::String ^ reason, System::String ^ action);

public static System.ServiceModel.Channels.Message CreateMessage (System.ServiceModel.Channels.MessageVersion version, System.ServiceModel.FaultCode faultCode, string reason, string action);

static member CreateMessage : System.ServiceModel.Channels.MessageVersion * System.ServiceModel.FaultCode * string * string -> System.ServiceModel.Channels.Message

Public Shared Function CreateMessage (version As MessageVersion, faultCode As FaultCode, reason As String, action As String) As Message

Parameter

version: MessageVersion

Objek MessageVersion yang menentukan versi SOAP yang akan digunakan untuk pesan.

faultCode: FaultCode

Objek MessageFault yang mewakili kesalahan SOAP.

reason: String

Alasan kesalahan SOAP.

action: String

Deskripsi tentang bagaimana pesan harus diproses.

Mengembalikan

Message

Objek Message untuk pesan yang dibuat.

Pengecualian

ArgumentNullException

version, fault, action atau faultCode adalah null.

Keterangan

Metode statis ini digunakan untuk membuat salinan pesan baru yang siap dikirim.

Berlaku untuk

CreateMessage(XmlReader, Int32, MessageVersion)

Sumber:: Message.cs

Sumber:: Message.cs

Sumber:: Message.cs

Membuat pesan menggunakan pembaca, tindakan, dan versi yang ditentukan.

public:
 static System::ServiceModel::Channels::Message ^ CreateMessage(System::Xml::XmlReader ^ envelopeReader, int maxSizeOfHeaders, System::ServiceModel::Channels::MessageVersion ^ version);

public static System.ServiceModel.Channels.Message CreateMessage (System.Xml.XmlReader envelopeReader, int maxSizeOfHeaders, System.ServiceModel.Channels.MessageVersion version);

static member CreateMessage : System.Xml.XmlReader * int * System.ServiceModel.Channels.MessageVersion -> System.ServiceModel.Channels.Message

Public Shared Function CreateMessage (envelopeReader As XmlReader, maxSizeOfHeaders As Integer, version As MessageVersion) As Message

Parameter

envelopeReader: XmlReader

Objek XmlReader yang akan digunakan untuk membaca pesan SOAP.

maxSizeOfHeaders: Int32

Ukuran maksimum dalam byte header.

version: MessageVersion

Objek MessageVersion yang menentukan versi SOAP yang akan digunakan untuk pesan.

Mengembalikan

Message

Objek Message untuk pesan yang dibuat.

Pengecualian

ArgumentNullException

envelopeReader atau version adalah null.

Keterangan

Message mengambil kepemilikan dari envelopeReader.

Metode ini membaca amplop, buffer semua header ke dalam koleksi header, dan membaca hingga tetapi tidak menyertakan Body tag mulai, dan mengembalikan pesan. Jika panggilan metode melemparkan pengecualian, itu menutup pembaca.

Isi pesan yang dikembalikan kemudian dapat dibaca atau ditulis.

Isi pesan dapat dibaca menggunakan GetBody metode pada pesan yang dikembalikan. Objek yang dikembalikan merangkum semua elemen anak dalam Body elemen . Isi pesan dapat ditulis menggunakan WriteBody atau WriteMessage. Setelah ditulis, itu tidak dapat dibaca.

Menutup pesan akan menutup pembaca amplop yang mendasar.

Berlaku untuk

CreateMessage(XmlDictionaryReader, Int32, MessageVersion)

Sumber:: Message.cs

Sumber:: Message.cs

Sumber:: Message.cs

Membuat pesan menggunakan pembaca, tindakan, dan versi yang ditentukan.

public:
 static System::ServiceModel::Channels::Message ^ CreateMessage(System::Xml::XmlDictionaryReader ^ envelopeReader, int maxSizeOfHeaders, System::ServiceModel::Channels::MessageVersion ^ version);

public static System.ServiceModel.Channels.Message CreateMessage (System.Xml.XmlDictionaryReader envelopeReader, int maxSizeOfHeaders, System.ServiceModel.Channels.MessageVersion version);

static member CreateMessage : System.Xml.XmlDictionaryReader * int * System.ServiceModel.Channels.MessageVersion -> System.ServiceModel.Channels.Message

Public Shared Function CreateMessage (envelopeReader As XmlDictionaryReader, maxSizeOfHeaders As Integer, version As MessageVersion) As Message

Parameter

envelopeReader: XmlDictionaryReader

Objek XmlDictionaryReader yang akan digunakan untuk membaca pesan SOAP.

maxSizeOfHeaders: Int32

Ukuran maksimum dalam byte header.

version: MessageVersion

Nilai valid MessageVersion yang menentukan versi SOAP yang akan digunakan untuk pesan.

Mengembalikan

Message

Objek Message untuk pesan yang dibuat.

Pengecualian

ArgumentNullException

envelopeReader atau version adalah null.

Keterangan

Message mengambil kepemilikan dari envelopeReader.

Isi pesan yang dikembalikan kemudian dapat dibaca atau ditulis.

Menutup pesan akan menutup pembaca amplop yang mendasar.

Berlaku untuk

CreateMessage(MessageVersion, String, XmlReader)

Sumber:: Message.cs

Sumber:: Message.cs

Sumber:: Message.cs

Membuat pesan menggunakan pembaca, tindakan, dan versi yang ditentukan.

public:
 static System::ServiceModel::Channels::Message ^ CreateMessage(System::ServiceModel::Channels::MessageVersion ^ version, System::String ^ action, System::Xml::XmlReader ^ body);

public static System.ServiceModel.Channels.Message CreateMessage (System.ServiceModel.Channels.MessageVersion version, string action, System.Xml.XmlReader body);

static member CreateMessage : System.ServiceModel.Channels.MessageVersion * string * System.Xml.XmlReader -> System.ServiceModel.Channels.Message

Public Shared Function CreateMessage (version As MessageVersion, action As String, body As XmlReader) As Message

Parameter

version: MessageVersion

Objek MessageVersion yang menentukan versi SOAP yang akan digunakan untuk pesan.

action: String

Deskripsi tentang bagaimana pesan harus diproses.

body: XmlReader

Objek XmlReader yang akan digunakan untuk membaca pesan SOAP.

Mengembalikan

Message

Objek Message untuk pesan yang dibuat.

Pengecualian

ArgumentNullException

version, action atau body adalah null.

Keterangan

Metode statis ini digunakan untuk membuat salinan pesan baru yang siap dikirim.

Berlaku untuk

CreateMessage(MessageVersion, String, Object, XmlObjectSerializer)

Sumber:: Message.cs

Sumber:: Message.cs

Sumber:: Message.cs

Membuat pesan menggunakan versi, tindakan, isi pesan, dan serializer yang ditentukan.

public:
 static System::ServiceModel::Channels::Message ^ CreateMessage(System::ServiceModel::Channels::MessageVersion ^ version, System::String ^ action, System::Object ^ body, System::Runtime::Serialization::XmlObjectSerializer ^ serializer);

public static System.ServiceModel.Channels.Message CreateMessage (System.ServiceModel.Channels.MessageVersion version, string action, object body, System.Runtime.Serialization.XmlObjectSerializer serializer);

static member CreateMessage : System.ServiceModel.Channels.MessageVersion * string * obj * System.Runtime.Serialization.XmlObjectSerializer -> System.ServiceModel.Channels.Message

Public Shared Function CreateMessage (version As MessageVersion, action As String, body As Object, serializer As XmlObjectSerializer) As Message

Parameter

version: MessageVersion

Objek MessageVersion yang menentukan versi SOAP yang akan digunakan untuk pesan.

action: String

Deskripsi tentang bagaimana pesan harus diproses.

body: Object

Isi pesan.

serializer: XmlObjectSerializer

Objek yang XmlObjectSerializer digunakan untuk membuat serial pesan.

Mengembalikan

Message

Objek Message untuk pesan yang dibuat.

Pengecualian

ArgumentNullException

version, fault atau action adalah null.

Keterangan

Metode statis ini digunakan untuk membuat salinan pesan baru yang siap dikirim.

Berlaku untuk

CreateMessage(MessageVersion, String, BodyWriter)

Sumber:: Message.cs

Sumber:: Message.cs

Sumber:: Message.cs

Membuat pesan dengan isi yang terdiri dari array byte.

public:
 static System::ServiceModel::Channels::Message ^ CreateMessage(System::ServiceModel::Channels::MessageVersion ^ version, System::String ^ action, System::ServiceModel::Channels::BodyWriter ^ body);

public static System.ServiceModel.Channels.Message CreateMessage (System.ServiceModel.Channels.MessageVersion version, string action, System.ServiceModel.Channels.BodyWriter body);

static member CreateMessage : System.ServiceModel.Channels.MessageVersion * string * System.ServiceModel.Channels.BodyWriter -> System.ServiceModel.Channels.Message

Public Shared Function CreateMessage (version As MessageVersion, action As String, body As BodyWriter) As Message

Parameter

version: MessageVersion

Objek MessageVersion yang menentukan versi SOAP yang akan digunakan untuk pesan.

action: String

Deskripsi tentang bagaimana pesan harus diproses.

body: BodyWriter

BodyWriter Jenis byte.

Mengembalikan

Message

Objek Message untuk pesan yang dibuat.

Pengecualian

ArgumentNullException

Version, action atau body adalah null.

Keterangan

Pesan kosong berguna bagi titik akhir untuk mengirim pemberitahuan ke titik akhir lain tanpa konten aktual.

Berlaku untuk

CreateMessage(MessageVersion, String, Object)

Sumber:: Message.cs

Sumber:: Message.cs

Sumber:: Message.cs

Membuat pesan dengan versi, tindakan, dan isi yang ditentukan.

public:
 static System::ServiceModel::Channels::Message ^ CreateMessage(System::ServiceModel::Channels::MessageVersion ^ version, System::String ^ action, System::Object ^ body);

public static System.ServiceModel.Channels.Message CreateMessage (System.ServiceModel.Channels.MessageVersion version, string action, object body);

static member CreateMessage : System.ServiceModel.Channels.MessageVersion * string * obj -> System.ServiceModel.Channels.Message

Public Shared Function CreateMessage (version As MessageVersion, action As String, body As Object) As Message

Parameter

version: MessageVersion

Objek MessageVersion yang menentukan versi SOAP yang akan digunakan untuk pesan.

action: String

Deskripsi tentang bagaimana pesan harus diproses.

body: Object

Isi pesan.

Mengembalikan

Message

Objek Message untuk pesan yang dibuat.

Pengecualian

ArgumentNullException

version, action atau body adalah null.

Keterangan

Metode statis ini digunakan untuk membuat salinan pesan baru yang siap dikirim.

Berlaku untuk

CreateMessage(MessageVersion, MessageFault, String)

Sumber:: Message.cs

Sumber:: Message.cs

Sumber:: Message.cs

Membuat pesan yang berisi kesalahan SOAP, versi, dan tindakan.

public:
 static System::ServiceModel::Channels::Message ^ CreateMessage(System::ServiceModel::Channels::MessageVersion ^ version, System::ServiceModel::Channels::MessageFault ^ fault, System::String ^ action);

public static System.ServiceModel.Channels.Message CreateMessage (System.ServiceModel.Channels.MessageVersion version, System.ServiceModel.Channels.MessageFault fault, string action);

static member CreateMessage : System.ServiceModel.Channels.MessageVersion * System.ServiceModel.Channels.MessageFault * string -> System.ServiceModel.Channels.Message

Public Shared Function CreateMessage (version As MessageVersion, fault As MessageFault, action As String) As Message

Parameter

version: MessageVersion

Objek MessageVersion yang menentukan versi SOAP yang akan digunakan untuk pesan.

fault: MessageFault

Objek MessageFault yang mewakili kesalahan SOAP.

action: String

Deskripsi tentang bagaimana pesan harus diproses.

Mengembalikan

Message

Objek Message untuk pesan yang dibuat.

Pengecualian

ArgumentNullException

Version, fault atau action adalah null.

Keterangan

Metode statis ini digunakan untuk membuat salinan pesan baru yang siap dikirim.

Berlaku untuk

CreateMessage(MessageVersion, String, XmlDictionaryReader)

Sumber:: Message.cs

Sumber:: Message.cs

Sumber:: Message.cs

Membuat pesan dengan versi, tindakan, dan isi yang ditentukan.

public:
 static System::ServiceModel::Channels::Message ^ CreateMessage(System::ServiceModel::Channels::MessageVersion ^ version, System::String ^ action, System::Xml::XmlDictionaryReader ^ body);

public static System.ServiceModel.Channels.Message CreateMessage (System.ServiceModel.Channels.MessageVersion version, string action, System.Xml.XmlDictionaryReader body);

static member CreateMessage : System.ServiceModel.Channels.MessageVersion * string * System.Xml.XmlDictionaryReader -> System.ServiceModel.Channels.Message

Public Shared Function CreateMessage (version As MessageVersion, action As String, body As XmlDictionaryReader) As Message

Parameter

version: MessageVersion

Objek MessageVersion yang menentukan versi SOAP yang akan digunakan untuk pesan.

action: String

Deskripsi tentang bagaimana pesan harus diproses.

body: XmlDictionaryReader

Isi pesan.

Mengembalikan

Message

Objek Message untuk pesan yang dibuat.

Pengecualian

ArgumentNullException

version, action atau body adalah null.

Keterangan

Metode statis ini digunakan untuk membuat salinan pesan baru yang siap dikirim.

Berlaku untuk

CreateMessage(MessageVersion, String)

Sumber:: Message.cs

Sumber:: Message.cs

Sumber:: Message.cs

Membuat pesan yang berisi versi dan tindakan.

public:
 static System::ServiceModel::Channels::Message ^ CreateMessage(System::ServiceModel::Channels::MessageVersion ^ version, System::String ^ action);

public static System.ServiceModel.Channels.Message CreateMessage (System.ServiceModel.Channels.MessageVersion version, string action);

static member CreateMessage : System.ServiceModel.Channels.MessageVersion * string -> System.ServiceModel.Channels.Message

Public Shared Function CreateMessage (version As MessageVersion, action As String) As Message

Parameter

version: MessageVersion

Objek MessageVersion yang menentukan versi SOAP yang akan digunakan untuk pesan.

action: String

Deskripsi tentang bagaimana pesan harus diproses.

Mengembalikan

Message

Objek Message untuk pesan yang dibuat.

Pengecualian

ArgumentNullException

version atau action adalah null.

Keterangan

Metode statis ini digunakan untuk membuat salinan pesan baru yang siap dikirim.

Berlaku untuk

Message.CreateMessage Metode

Definisi

Overload

Contoh

Keterangan

CreateMessage(MessageVersion, FaultCode, String, Object, String)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

CreateMessage(MessageVersion, FaultCode, String, String)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

CreateMessage(XmlReader, Int32, MessageVersion)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

CreateMessage(XmlDictionaryReader, Int32, MessageVersion)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

CreateMessage(MessageVersion, String, XmlReader)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

CreateMessage(MessageVersion, String, Object, XmlObjectSerializer)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

CreateMessage(MessageVersion, String, BodyWriter)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

CreateMessage(MessageVersion, String, Object)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

CreateMessage(MessageVersion, MessageFault, String)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

CreateMessage(MessageVersion, String, XmlDictionaryReader)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

CreateMessage(MessageVersion, String)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

Saran dan Komentar

Sumber Daya Tambahan: