Message Sınıf

Tanım

public ref class Message abstract : IDisposable

public abstract class Message : IDisposable

type Message = class
    interface IDisposable

Public MustInherit Class Message
Implements IDisposable

Devralma

Object

Message

Uygulamalar

IDisposable

Örnekler

Aşağıdaki kod örneği, ileti göndermek ve yanıtı okumak için kanal fabrikasını kullanan bir istemciyi gösterir.

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

Açıklamalar

sınıfı, Message ağdaki bir gönderen ve alıcı arasında rastgele bilgiler iletmenin bir aracıdır. Bilgileri aktarmak, bir eylem kursu önermek veya talep etmek ya da veri istemek için kullanılabilir.

Nesnenin Message yapısı SOAP zarfını temsil eder. İki ayrı bölümden oluşur: iletinin gövdesi ve sınıfı tarafından Headers temsil edilen isteğe bağlı üst bilgi koleksiyonu. İleti içeriği, bir gönderenden alıcıya gönderilen uygulama tanımlı verilerdir. İleti üst bilgileri, değişen gereksinimleri karşılamak için sistem ve uygulama genişletilebilirliğini etkinleştirir, çünkü belirli üst bilgileri işlemek ve yanıtlamak için kod tanımlayabilirsiniz. Kendi üst bilgilerinizi de tanımlayabilirsiniz. İleti üst bilgileri, iletinin içeriğiyle birlikte seri hale getirilir veya seri durumdan çıkarılır.

İletiler belirli biçimlerde alınır ve gönderilir. İki biçim için destek sağlanır: standart metin tabanlı XML biçimi ve ikili tabanlı XML biçimi. Message Nesnesi hem SOAP 1.1 hem de SOAP 1.2 zarflarını temsil etmek için kullanılabilir. örneğinin Message oluşturma sırasında düzeltildiğini ve belirli bir SOAP sürümüne bağlı olduğunu unutmayın. özelliği, Version iletinin SOAP sürümünü temsil eder.

Bir Message nesne, yöntemi kullanılarak bir dış depoya WriteMessage seri hale getirilebilir. İletinin özellikleri de seri hale getirilebilir, ancak ayrı ayrı tanımlanıp seri hale getirilmelidir. Bellek Message içi nesne oluşturmak için bir iletiyi seri durumdan çıkarma işlemi kullanılarak CreateMessageyapılabilir. Özellikler ayrıca tek tek seri durumdan çıkarılmalı ve belirli Message bir örnek için özellik koleksiyonuna el ile eklenmelidir.

Nesnenin Message boyutu, iletilen verilerin boyutuna sabittir. Her gövde, örneğin sarmalandığı akışın XmlReaderXmlReader boyutu üzerinde önceden tanımlanmış bir sınır olmadan bir örneği olarak modellenmiştir. Ancak belirli kanal sağlayıcıları, işledikleri iletilerin boyutu üzerinde bir sınıra sahip olabilir.

bir Message , iletiyi inceleyen ve işleyen bir varlık tarafından oluşturulan yararlı bilgilerle not eklenebilir. Bu işlevsellik ve Properties özellikleri tarafından Headers sağlanır. Koleksiyon, Headers iletideki SOAP üst bilgileri kümesini temsil eder.

özelliği, Properties iletideki işlem düzeyi ek açıklamaları kümesini temsil eder. Üst bilgilerdeki bilgiler kabloya iletildiğinden, üst bilgiyi inceleyen bir varlık, üst bilgi tarafından kullanılan protokollerin temel sürümlerini desteklemelidir. Ancak özellikler, iletiye açıklama eklemenin sürümden bağımsız bir yolunu sağlar.

Örnek Message oluşturmak için yöntemlerden CreateMessage birini kullanın.

Bir iletinin tüketicisinin iletinin içeriğine erişmeyi bitirdiğinde her zaman araması Close önerilir. Bu eylem, iletinin ömrüne bağlı sonlu sistem kaynaklarını (örneğin, yuvalar, adlandırılmış kanallar) serbest kalır.

Bu sınıftan türetilen Yönetilen C++ kullanıcıları için özel not:

• Temizleme kodunuzu bir yıkıcıya değil (On)(Begin)Close (ve/veya OnAbort) içine yerleştirin.

• Yıkıcılardan kaçının: derleyicinin otomatik olarak oluşturmasına IDisposableneden olur.

• Başvuru olmayan üyelerden kaçının: derleyicinin otomatik olarak oluşturmasına IDisposableneden olabilirler.

• Sonlandırıcılardan kaçının; ancak bir tane eklerseniz, otomatik oluşturulan IDisposable davranışın ne olduğunu öykünmek için derleme uyarısını ve çağrısını SuppressFinalize(Object) ve sonlandırıcıyı (On)(Begin)Close (ve/veya OnAbort) öğesinden gizleyin.

Uygulayanlara Notlar

'den Messagedevraldığınızda, şu üyeleri geçersiz kılmalısınız: Headers, ve Version.

Oluşturucular

Özellikler

Yöntemler

Belirtik Arabirim Kullanımları

Uzantı Metotları

Şunlara uygulanır