Message Clase

Definición

public ref class Message abstract : IDisposable

public abstract class Message : IDisposable

type Message = class
    interface IDisposable

Public MustInherit Class Message
Implements IDisposable

Herencia

Object

Message

Implementaciones

IDisposable

Ejemplos

En el ejemplo de código siguiente se muestra un cliente que usa el generador de canales para enviar un mensaje y leer la respuesta.

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

Comentarios

La clase Message proporciona un medio para comunicar la información arbitraria entre un remitente y un destinatario en una red. Se puede utilizar para retransmitir información, sugerir o exigir un curso de acción o solicitar datos.

La estructura de un objeto Message representa una envoltura SOAP. Se compone de dos partes distintas: el cuerpo del mensaje y una colección opcional de encabezados, representados por la clase Headers. El contenido del mensaje son datos definidos por la aplicación enviados de un remitente a un destinatario. Los encabezados del mensaje permiten al sistema y a la extensibilidad de la aplicación cumplir los requisitos cambiantes, porque puede definir el código para manipular y responder a encabezados específicos. También puede definir sus propios encabezados. Los encabezados del mensaje se serializan o deserializan junto con el contenido del mensaje.

Los mensajes se reciben y envían en formatos determinados. Se proporciona compatibilidad para dos formatos: el formato XML basado en texto estándar y un formato XML basado en binario. El objeto Message se puede utilizar para representar SOAP 1.1 y envolturas de SOAP 1.2. Observe que una instancia de Message se fija al ser creada y se enlaza con una versión SOAP específica. La propiedad Version representa la versión SOAP del mensaje.

Un objeto Message se puede serializar a un almacén externo utilizando el método WriteMessage. También se pueden serializar propiedades del mensaje, pero tienen que ser identificadas individualmente y serializadas por separado. Deserializar un mensaje para crear un objeto Message en memoria se puede hacer utilizando CreateMessage. Las propiedades también se deben deserializar individualmente y agregar manualmente a la colección de propiedades para la instancia Message específica.

El tamaño de un objeto Message se fija según el tamaño de los datos que está transmitiendo. Cada cuerpo se modela como una instancia de XmlReader, sin el límite predefinido en el tamaño de la secuencia que la instancia XmlReader está ajustando. Sin embargo, los proveedores específicos de canal pueden tener un límite en el tamaño de los mensajes que procesan.

Message se puede anotar con información útil generada por una entidad que ha examinado y procesado el mensaje. Headers y las propiedades Properties proporcionan esta funcionalidad. La colección Headers representa el conjunto de encabezados SOAP en el mensaje.

La propiedad Properties representa el conjunto de anotaciones del nivel de procesamiento en el mensaje. Puesto que la información en los encabezados se transmite en la conexión, una entidad que examina un encabezado debe admitir las versiones subyacentes de los protocolos utilizados por el encabezado. Sin embargo, las propiedades proporcionan una manera más independiente de la versión de anotar un mensaje.

Para crear una instancia Message, utilice uno de los métodos CreateMessage.

Se recomienda que un consumidor de un mensaje siempre llame a Close cuando termine de tener acceso al contenido del mensaje. Esta acción libera recursos finitos del sistema (por ejemplo, sockets, canalizaciones con nombre) que condicionan la duración del mensaje.

Nota especial para los usuarios de C++ que deriven de esta clase:

• Coloque su código de limpieza en (On)(Begin)Close (y/o OnAbort), no en un destructor.

• Evite los destructores: hacen que el compilador genere automáticamente IDisposable

• Evite los miembros sin referencia: pueden hacer que el compilador genere automáticamente IDisposable.

• Evite los finalizadores; pero si incluye uno, suprima la advertencia de compilación y llame a SuppressFinalize(Object) y al propio finalizador de (On)(Begin)Close (y/o OnAbort) para emular lo que habría sido el comportamiento de IDisposable generado automáticamente.

Notas a los implementadores

Al heredar de Message, es necesario reemplazar los miembros siguientes: Headers y Version.

Constructores

Propiedades

Métodos

Implementaciones de interfaz explícitas

Métodos de extensión

Se aplica a