Message Klass

Definition

public ref class Message abstract : IDisposable

public abstract class Message : IDisposable

type Message = class
    interface IDisposable

Public MustInherit Class Message
Implements IDisposable

Arv

Object

Message

Implementeringar

IDisposable

Exempel

I följande kodexempel visas en klient som använder kanalfabriken för att skicka ett meddelande och läsa svaret.

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

Kommentarer

Klassen Message tillhandahåller ett sätt att kommunicera godtycklig information mellan en avsändare och en mottagare i ett nätverk. Den kan användas för att vidarebefordra information, föreslå eller kräva en åtgärd eller begära data.

Strukturen för ett Message objekt representerar ett SOAP-kuvert. Den består av två distinkta delar: meddelandets brödtext och en valfri samling rubriker som representeras av Headers klassen. Meddelandeinnehållet är programdefinierade data som skickas från en avsändare till en mottagare. Meddelandehuvudena aktiverar system- och programextensibilitet för att uppfylla de ändrade kraven, eftersom du kan definiera kod för att manipulera och svara på specifika rubriker. Du kan också definiera dina egna rubriker. Meddelandehuvuden serialiseras eller deserialiseras tillsammans med innehållet i meddelandet.

Meddelanden tas emot och skickas i vissa format. Stöd ges för två format: standardtextbaserat XML-format och ett binärbaserat XML-format. Objektet Message kan användas för att representera både SOAP 1.1- och SOAP 1.2-kuvert. Observera att en instans av Message korrigeras när den skapas och är bunden till en specifik SOAP-version. Egenskapen Version representerar SOAP-versionen av meddelandet.

Ett Message objekt kan serialiseras till ett externt arkiv med hjälp WriteMessage av metoden . Egenskaperna för meddelandet kan också serialiseras, men de måste identifieras individuellt och serialiseras separat. Att deserialisera ett meddelande för att skapa ett minnesinternt Message objekt kan göras med hjälp av CreateMessage. Egenskaper måste också deserialiseras individuellt och läggas till manuellt i egenskapssamlingen för den specifika Message instansen.

Storleken på ett Message objekt är fast i storleken på data som överförs. Varje brödtext modelleras som en instans av XmlReader, utan någon fördefinierad gräns för storleken på strömmen som instansen XmlReader omsluter. Specifika kanalprovidrar kan dock ha en gräns för storleken på meddelanden som de bearbetar.

En Message kan kommenteras med användbar information som genereras av en entitet som har granskat och bearbetat meddelandet. Den här funktionen tillhandahålls av Headers egenskaperna och Properties . Samlingen Headers representerar uppsättningen SOAP-huvuden i meddelandet.

Egenskapen Properties representerar uppsättningen anteckningar på bearbetningsnivå i meddelandet. Eftersom information i huvuden överförs på tråden måste en entitet som undersöker ett huvud ha stöd för de underliggande versionerna av de protokoll som används av huvudet. Egenskaper ger dock ett mer versionsoberoende sätt att kommentera ett meddelande.

Om du vill skapa en Message instans använder du någon av CreateMessage metoderna.

Vi rekommenderar att en konsument av ett meddelande alltid anropar Close när konsumenten har åtkomst till innehållet i meddelandet. Den här åtgärden frigör begränsade systemresurser (till exempel sockets, namngivna pipes) som är knutna till meddelandets livslängd.

Särskild anmärkning för hanterade C++-användare som härleds från den här klassen:

• Placera din rensningskod i (På)(Begin)Close (och/eller OnAbort), inte i en destruktor.
• Undvik destructors: de gör att kompilatorn automatiskt genererar IDisposable.
• Undvik icke-referensmedlemmar: de kan göra så att kompilatorn automatiskt genererar IDisposable.
• Undvik finalizers; men om du inkluderar en, utelämnar du byggvarningen och anropet SuppressFinalize(Object) och själva slutföraren från (På)(Begin)Close (och/eller OnAbort) för att emulera vad som skulle ha varit det automatiskt genererade beteendet IDisposable .

Anteckningar till implementerare

När du ärver från Messagemåste du åsidosätta följande medlemmar: Headers, och Version.