Message.CreateMessage Método

Definição

Espaço de Nomes:: System.ServiceModel.Channels

Assemblagens:: System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Assemblagem:: System.ServiceModel.dll

Assemblagem:: System.ServiceModel.Primitives.dll

Pacote:: System.ServiceModel.Primitives v10.0.652802

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Cria uma mensagem.

Sobrecargas

Name	Description
CreateMessage(MessageVersion, FaultCode, String, Object, String)	Cria uma mensagem que contém uma falha SOAP, uma razão e o detalhe da falha, uma versão e uma ação.
CreateMessage(MessageVersion, String, Object, XmlObjectSerializer)	Cria uma mensagem usando a versão, ação, corpo da mensagem e serializador especificados.
CreateMessage(MessageVersion, FaultCode, String, String)	Cria uma mensagem que contém uma falha SOAP, a razão da falha, uma versão e uma ação.
CreateMessage(XmlDictionaryReader, Int32, MessageVersion)	Cria uma mensagem usando o leitor, ação e versão especificados.
CreateMessage(MessageVersion, String, XmlReader)	Cria uma mensagem usando o leitor, ação e versão especificados.
CreateMessage(XmlReader, Int32, MessageVersion)	Cria uma mensagem usando o leitor, ação e versão especificados.
CreateMessage(MessageVersion, String, BodyWriter)	Cria uma mensagem com um corpo que consiste num array de bytes.
CreateMessage(MessageVersion, String, Object)	Cria uma mensagem com a versão, ação e corpo especificados.
CreateMessage(MessageVersion, MessageFault, String)	Cria uma mensagem que contém uma falha SOAP, uma versão e uma ação.
CreateMessage(MessageVersion, String)	Cria uma mensagem que contém uma versão e uma ação.
CreateMessage(MessageVersion, String, XmlDictionaryReader)	Cria uma mensagem com a versão, ação e corpo especificados.

Exemplos

O exemplo de código seguinte mostra um cliente que usa a channel factory para enviar uma mensagem e ler a resposta.

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

Observações

Este método é usado para criar uma nova cópia de uma mensagem pronta a ser enviada.

Ao trabalhar com mensagens JSON, utiliza-se o CreateMessage(MessageVersion, String, Object, XmlObjectSerializer) método, este CreateMessage(MessageVersion, String, Object) não funciona com mensagens JSON.

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

Origem:: Message.cs

Origem:: Message.cs

Origem:: Message.cs

Cria uma mensagem que contém uma falha SOAP, uma razão e o detalhe da falha, uma versão e uma ação.

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

Parâmetros

version: MessageVersion

Um MessageVersion objeto que especifica a versão SOAP a usar para a mensagem.

faultCode: FaultCode

Um MessageFault objeto que representa uma falha SOAP.

reason: String

A razão da falha do SOAP.

detail: Object

Os detalhes da falha SOAP.

action: String

Uma descrição de como a mensagem deve ser processada.

Devoluções

Message

Um Message objeto para a mensagem criada.

Exceções

ArgumentNullException

version, fault, action, detail ou faultCode é null.

Observações

Este método estático é usado para criar uma nova cópia da mensagem pronta para envio.

Aplica-se a

CreateMessage(MessageVersion, String, Object, XmlObjectSerializer)

Origem:: Message.cs

Origem:: Message.cs

Origem:: Message.cs

Cria uma mensagem usando a versão, ação, corpo da mensagem e serializador especificados.

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

Parâmetros

version: MessageVersion

Um MessageVersion objeto que especifica a versão SOAP a usar para a mensagem.

action: String

Uma descrição de como a mensagem deve ser processada.

body: Object

O corpo da mensagem.

serializer: XmlObjectSerializer

Um XmlObjectSerializer objeto usado para serializar a mensagem.

Devoluções

Message

Um Message objeto para a mensagem criada.

Exceções

ArgumentNullException

version, fault ou action é null.

Observações

Este método estático é usado para criar uma nova cópia da mensagem pronta para envio.

Aplica-se a

CreateMessage(MessageVersion, FaultCode, String, String)

Origem:: Message.cs

Origem:: Message.cs

Origem:: Message.cs

Cria uma mensagem que contém uma falha SOAP, a razão da falha, uma versão e uma ação.

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

Parâmetros

version: MessageVersion

Um MessageVersion objeto que especifica a versão SOAP a usar para a mensagem.

faultCode: FaultCode

Um MessageFault objeto que representa uma falha SOAP.

reason: String

A razão da falha do SOAP.

action: String

Uma descrição de como a mensagem deve ser processada.

Devoluções

Message

Um Message objeto para a mensagem criada.

Exceções

ArgumentNullException

version, fault, action ou faultCode é null.

Observações

Este método estático é usado para criar uma nova cópia da mensagem pronta para envio.

Aplica-se a

CreateMessage(XmlDictionaryReader, Int32, MessageVersion)

Origem:: Message.cs

Origem:: Message.cs

Origem:: Message.cs

Cria uma mensagem usando o leitor, ação e versão especificados.

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

Parâmetros

envelopeReader: XmlDictionaryReader

O XmlDictionaryReader objeto a ser usado para ler a mensagem SOAP.

maxSizeOfHeaders: Int32

O tamanho máximo em bytes de um cabeçalho.

version: MessageVersion

Um valor válido MessageVersion que especifica a versão SOAP a usar para a mensagem.

Devoluções

Message

Um Message objeto para a mensagem criada.

Exceções

ArgumentNullException

envelopeReader ou version é null.

Observações

Message assume a propriedade de envelopeReader.

Este método lê o envelope, armazena todos os cabeçalhos na coleção de cabeçalhos, lê até, mas não incluindo, Body a etiqueta inicial, e devolve a mensagem. Se a chamada de método lançar uma exceção, fecha o leitor.

O corpo da mensagem devolvida pode então ser lido ou escrito.

O corpo da mensagem pode ser lido usando os GetBody métodos da mensagem devolvida. O objeto devolvido encapsula todos os elementos filhos dentro do Body elemento. O corpo da mensagem pode ser escrito usando WriteBody ou WriteMessage. Uma vez escrito, não pode ser lido.

Fechar a mensagem fecha o leitor de envelope subjacente.

Aplica-se a

CreateMessage(MessageVersion, String, XmlReader)

Origem:: Message.cs

Origem:: Message.cs

Origem:: Message.cs

Cria uma mensagem usando o leitor, ação e versão especificados.

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

Parâmetros

version: MessageVersion

Um MessageVersion objeto que especifica a versão SOAP a usar para a mensagem.

action: String

Uma descrição de como a mensagem deve ser processada.

body: XmlReader

O XmlReader objeto a ser usado para ler a mensagem SOAP.

Devoluções

Message

Um Message objeto para a mensagem criada.

Exceções

ArgumentNullException

version, action ou body é null.

Observações

Este método estático é usado para criar uma nova cópia da mensagem pronta para envio.

Aplica-se a

CreateMessage(XmlReader, Int32, MessageVersion)

Origem:: Message.cs

Origem:: Message.cs

Origem:: Message.cs

Cria uma mensagem usando o leitor, ação e versão especificados.

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

Parâmetros

envelopeReader: XmlReader

O XmlReader objeto a ser usado para ler a mensagem SOAP.

maxSizeOfHeaders: Int32

O tamanho máximo em bytes de um cabeçalho.

version: MessageVersion

Um MessageVersion objeto que especifica a versão SOAP a usar para a mensagem.

Devoluções

Message

Um Message objeto para a mensagem criada.

Exceções

ArgumentNullException

envelopeReader ou version é null.

Observações

Message assume a propriedade de envelopeReader.

O corpo da mensagem devolvida pode então ser lido ou escrito.

Fechar a mensagem fecha o leitor de envelope subjacente.

Aplica-se a

CreateMessage(MessageVersion, String, BodyWriter)

Origem:: Message.cs

Origem:: Message.cs

Origem:: Message.cs

Cria uma mensagem com um corpo que consiste num array de bytes.

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

Parâmetros

version: MessageVersion

Um MessageVersion objeto que especifica a versão SOAP a usar para a mensagem.

action: String

Uma descrição de como a mensagem deve ser processada.

body: BodyWriter

Um BodyWriter byte de tipo.

Devoluções

Message

Um Message objeto para a mensagem criada.

Exceções

ArgumentNullException

Version, action ou body é null.

Observações

Uma mensagem vazia é útil para um endpoint enviar um alerta para outro endpoint sem qualquer conteúdo real.

Aplica-se a

CreateMessage(MessageVersion, String, Object)

Origem:: Message.cs

Origem:: Message.cs

Origem:: Message.cs

Cria uma mensagem com a versão, ação e corpo especificados.

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

Parâmetros

version: MessageVersion

Um MessageVersion objeto que especifica a versão SOAP a usar para a mensagem.

action: String

Uma descrição de como a mensagem deve ser processada.

body: Object

O corpo da mensagem.

Devoluções

Message

Um Message objeto para a mensagem criada.

Exceções

ArgumentNullException

version, action ou body é null.

Observações

Este método estático é usado para criar uma nova cópia da mensagem pronta para envio.

Aplica-se a

CreateMessage(MessageVersion, MessageFault, String)

Origem:: Message.cs

Origem:: Message.cs

Origem:: Message.cs

Cria uma mensagem que contém uma falha SOAP, uma versão e uma ação.

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

Parâmetros

version: MessageVersion

Um MessageVersion objeto que especifica a versão SOAP a usar para a mensagem.

fault: MessageFault

Um MessageFault objeto que representa uma falha SOAP.

action: String

Uma descrição de como a mensagem deve ser processada.

Devoluções

Message

Um Message objeto para a mensagem criada.

Exceções

ArgumentNullException

Version, fault ou action é null.

Observações

Este método estático é usado para criar uma nova cópia da mensagem pronta para envio.

Aplica-se a

CreateMessage(MessageVersion, String)

Origem:: Message.cs

Origem:: Message.cs

Origem:: Message.cs

Cria uma mensagem que contém uma versão e uma ação.

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

Parâmetros

version: MessageVersion

Um MessageVersion objeto que especifica a versão SOAP a usar para a mensagem.

action: String

Uma descrição de como a mensagem deve ser processada.

Devoluções

Message

Um Message objeto para a mensagem criada.

Exceções

ArgumentNullException

version ou action é null.

Observações

Este método estático é usado para criar uma nova cópia da mensagem pronta para envio.

Aplica-se a

CreateMessage(MessageVersion, String, XmlDictionaryReader)

Origem:: Message.cs

Origem:: Message.cs

Origem:: Message.cs

Cria uma mensagem com a versão, ação e corpo especificados.

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

Parâmetros

version: MessageVersion

Um MessageVersion objeto que especifica a versão SOAP a usar para a mensagem.

action: String

Uma descrição de como a mensagem deve ser processada.

body: XmlDictionaryReader

O corpo da mensagem.

Devoluções

Message

Um Message objeto para a mensagem criada.

Exceções

ArgumentNullException

version, action ou body é null.

Observações

Este método estático é usado para criar uma nova cópia da mensagem pronta para envio.

Aplica-se a

Comentários

Esta página foi útil?