Message.CreateMessage Méthode

Définition

Espace de noms:: System.ServiceModel.Channels

Assemblys:: System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Assembly:: System.ServiceModel.dll

Assembly:: System.ServiceModel.Primitives.dll

Paquet:: System.ServiceModel.Primitives v10.0.652802

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Crée un message.

Surcharges

Nom	Description
CreateMessage(MessageVersion, FaultCode, String, Object, String)	Crée un message qui contient une erreur SOAP, une raison et les détails de l’erreur, une version et une action.
CreateMessage(MessageVersion, String, Object, XmlObjectSerializer)	Crée un message à l’aide de la version, de l’action, du corps du message et du sérialiseur spécifiés.
CreateMessage(MessageVersion, FaultCode, String, String)	Crée un message qui contient une erreur SOAP, la raison de l’erreur, une version et une action.
CreateMessage(XmlDictionaryReader, Int32, MessageVersion)	Crée un message à l’aide du lecteur, de l’action et de la version spécifiés.
CreateMessage(MessageVersion, String, XmlReader)	Crée un message à l’aide du lecteur, de l’action et de la version spécifiés.
CreateMessage(XmlReader, Int32, MessageVersion)	Crée un message à l’aide du lecteur, de l’action et de la version spécifiés.
CreateMessage(MessageVersion, String, BodyWriter)	Crée un message avec un corps constitué d’un tableau d’octets.
CreateMessage(MessageVersion, String, Object)	Crée un message avec la version, l’action et le corps spécifiés.
CreateMessage(MessageVersion, MessageFault, String)	Crée un message qui contient une erreur SOAP, une version et une action.
CreateMessage(MessageVersion, String)	Crée un message qui contient une version et une action.
CreateMessage(MessageVersion, String, XmlDictionaryReader)	Crée un message avec la version, l’action et le corps spécifiés.

Exemples

L’exemple de code suivant montre un client qui utilise la fabrique de canaux pour envoyer un message et lire la réponse.

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

Remarques

Cette méthode est utilisée pour créer une nouvelle copie d’un message prêt pour l’envoi.

Lorsque vous utilisez des messages CreateMessage(MessageVersion, String, Object, XmlObjectSerializer) JSON, la CreateMessage(MessageVersion, String, Object) méthode ne fonctionne pas avec les messages JSON.

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

Source:: Message.cs

Source:: Message.cs

Source:: Message.cs

Crée un message qui contient une erreur SOAP, une raison et les détails de l’erreur, une version et une action.

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

Paramètres

version: MessageVersion

Objet MessageVersion qui spécifie la version SOAP à utiliser pour le message.

faultCode: FaultCode

Objet MessageFault qui représente une erreur SOAP.

reason: String

Raison de l’erreur SOAP.

detail: Object

Détails de l’erreur SOAP.

action: String

Description de la façon dont le message doit être traité.

Retours

Message

Objet Message du message créé.

Exceptions

ArgumentNullException

version, fault, actiondetail ou faultCode est null.

Remarques

Cette méthode statique est utilisée pour créer une nouvelle copie de message prête pour l’envoi.

S’applique à

CreateMessage(MessageVersion, String, Object, XmlObjectSerializer)

Source:: Message.cs

Source:: Message.cs

Source:: Message.cs

Crée un message à l’aide de la version, de l’action, du corps du message et du sérialiseur spécifiés.

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

Paramètres

version: MessageVersion

Objet MessageVersion qui spécifie la version SOAP à utiliser pour le message.

action: String

Description de la façon dont le message doit être traité.

body: Object

Corps du message.

serializer: XmlObjectSerializer

Objet XmlObjectSerializer utilisé pour sérialiser le message.

Retours

Message

Objet Message du message créé.

Exceptions

ArgumentNullException

version fault ou action est null.

Remarques

Cette méthode statique est utilisée pour créer une nouvelle copie de message prête pour l’envoi.

S’applique à

CreateMessage(MessageVersion, FaultCode, String, String)

Source:: Message.cs

Source:: Message.cs

Source:: Message.cs

Crée un message qui contient une erreur SOAP, la raison de l’erreur, une version et une action.

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

Paramètres

version: MessageVersion

Objet MessageVersion qui spécifie la version SOAP à utiliser pour le message.

faultCode: FaultCode

Objet MessageFault qui représente une erreur SOAP.

reason: String

Raison de l’erreur SOAP.

action: String

Description de la façon dont le message doit être traité.

Retours

Message

Objet Message du message créé.

Exceptions

ArgumentNullException

version, faultaction ou faultCode est null.

Remarques

Cette méthode statique est utilisée pour créer une nouvelle copie de message prête pour l’envoi.

S’applique à

CreateMessage(XmlDictionaryReader, Int32, MessageVersion)

Source:: Message.cs

Source:: Message.cs

Source:: Message.cs

Crée un message à l’aide du lecteur, de l’action et de la version spécifiés.

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

Paramètres

envelopeReader: XmlDictionaryReader

Objet XmlDictionaryReader à utiliser pour lire le message SOAP.

maxSizeOfHeaders: Int32

Taille maximale en octets d’un en-tête.

version: MessageVersion

Valeur valide MessageVersion qui spécifie la version SOAP à utiliser pour le message.

Retours

Message

Objet Message du message créé.

Exceptions

ArgumentNullException

envelopeReader ou version est null.

Remarques

Message prend possession de envelopeReader.

Cette méthode lit l’enveloppe, met en mémoire tampon tous les en-têtes dans la collection d’en-têtes et lit jusqu’à la Body balise de début, puis retourne le message. Si l’appel de méthode lève une exception, il ferme le lecteur.

Le corps du message retourné peut ensuite être lu ou écrit.

Le corps du message peut être lu à l’aide des GetBody méthodes du message retourné. L’objet retourné encapsule tous les éléments enfants dans l’élément Body . Le corps du message peut être écrit à l’aide WriteBody ou WriteMessage. Une fois écrit, il ne peut pas être lu.

La fermeture du message ferme le lecteur d’enveloppe sous-jacent.

S’applique à

CreateMessage(MessageVersion, String, XmlReader)

Source:: Message.cs

Source:: Message.cs

Source:: Message.cs

Crée un message à l’aide du lecteur, de l’action et de la version spécifiés.

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

Paramètres

version: MessageVersion

Objet MessageVersion qui spécifie la version SOAP à utiliser pour le message.

action: String

Description de la façon dont le message doit être traité.

body: XmlReader

Objet XmlReader à utiliser pour lire le message SOAP.

Retours

Message

Objet Message du message créé.

Exceptions

ArgumentNullException

version action ou body est null.

Remarques

Cette méthode statique est utilisée pour créer une nouvelle copie de message prête pour l’envoi.

S’applique à

CreateMessage(XmlReader, Int32, MessageVersion)

Source:: Message.cs

Source:: Message.cs

Source:: Message.cs

Crée un message à l’aide du lecteur, de l’action et de la version spécifiés.

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

Paramètres

envelopeReader: XmlReader

Objet XmlReader à utiliser pour lire le message SOAP.

maxSizeOfHeaders: Int32

Taille maximale en octets d’un en-tête.

version: MessageVersion

Objet MessageVersion qui spécifie la version SOAP à utiliser pour le message.

Retours

Message

Objet Message du message créé.

Exceptions

ArgumentNullException

envelopeReader ou version est null.

Remarques

Message prend possession de envelopeReader.

Le corps du message retourné peut ensuite être lu ou écrit.

La fermeture du message ferme le lecteur d’enveloppe sous-jacent.

S’applique à

CreateMessage(MessageVersion, String, BodyWriter)

Source:: Message.cs

Source:: Message.cs

Source:: Message.cs

Crée un message avec un corps constitué d’un tableau d’octets.

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

Paramètres

version: MessageVersion

Objet MessageVersion qui spécifie la version SOAP à utiliser pour le message.

action: String

Description de la façon dont le message doit être traité.

body: BodyWriter

Octet BodyWriter de type.

Retours

Message

Objet Message du message créé.

Exceptions

ArgumentNullException

Version action ou body est null.

Remarques

Un message vide est utile pour qu’un point de terminaison envoie une alerte à un autre point de terminaison sans contenu réel.

S’applique à

CreateMessage(MessageVersion, String, Object)

Source:: Message.cs

Source:: Message.cs

Source:: Message.cs

Crée un message avec la version, l’action et le corps spécifiés.

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

Paramètres

version: MessageVersion

Objet MessageVersion qui spécifie la version SOAP à utiliser pour le message.

action: String

Description de la façon dont le message doit être traité.

body: Object

Corps du message.

Retours

Message

Objet Message du message créé.

Exceptions

ArgumentNullException

version action ou body est null.

Remarques

Cette méthode statique est utilisée pour créer une nouvelle copie de message prête pour l’envoi.

S’applique à

CreateMessage(MessageVersion, MessageFault, String)

Source:: Message.cs

Source:: Message.cs

Source:: Message.cs

Crée un message qui contient une erreur SOAP, une version et une action.

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

Paramètres

version: MessageVersion

Objet MessageVersion qui spécifie la version SOAP à utiliser pour le message.

fault: MessageFault

Objet MessageFault qui représente une erreur SOAP.

action: String

Description de la façon dont le message doit être traité.

Retours

Message

Objet Message du message créé.

Exceptions

ArgumentNullException

Version fault ou action est null.

Remarques

Cette méthode statique est utilisée pour créer une nouvelle copie de message prête pour l’envoi.

S’applique à

CreateMessage(MessageVersion, String)

Source:: Message.cs

Source:: Message.cs

Source:: Message.cs

Crée un message qui contient une version et une action.

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

Paramètres

version: MessageVersion

Objet MessageVersion qui spécifie la version SOAP à utiliser pour le message.

action: String

Description de la façon dont le message doit être traité.

Retours

Message

Objet Message du message créé.

Exceptions

ArgumentNullException

version ou action est null.

Remarques

Cette méthode statique est utilisée pour créer une nouvelle copie de message prête pour l’envoi.

S’applique à

CreateMessage(MessageVersion, String, XmlDictionaryReader)

Source:: Message.cs

Source:: Message.cs

Source:: Message.cs

Crée un message avec la version, l’action et le corps spécifiés.

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

Paramètres

version: MessageVersion

Objet MessageVersion qui spécifie la version SOAP à utiliser pour le message.

action: String

Description de la façon dont le message doit être traité.

body: XmlDictionaryReader

Corps du message.

Retours

Message

Objet Message du message créé.

Exceptions

ArgumentNullException

version action ou body est null.

Remarques

Cette méthode statique est utilisée pour créer une nouvelle copie de message prête pour l’envoi.

S’applique à

Commentaires

Cette page a-t-elle été utile ?