Message.CreateMessage Méthode

Référence

Définition

Espace de noms:: System.ServiceModel.Channels

Assembly:: System.ServiceModel.Primitives.dll

Assembly:: System.ServiceModel.dll

Paquet:: System.ServiceModel.Primitives v6.0.0

Paquet:: System.ServiceModel.Primitives v6.2.0

Paquet:: System.ServiceModel.Primitives v8.0.0

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

CreateMessage(MessageVersion, FaultCode, String, Object, String)	Crée un message qui contient une erreur SOAP, son motif et les informations relatives à l'erreur, une version et une action.
CreateMessage(MessageVersion, FaultCode, String, String)	Crée un message qui contient une erreur SOAP, son motif, la version et une action.
CreateMessage(XmlReader, Int32, MessageVersion)	Crée un message à l'aide du lecteur, de l'action et de la version spécifiés.
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(MessageVersion, String, Object, XmlObjectSerializer)	Crée un message à l'aide de la version, l'action, le corps du message et le sérialiseur spécifiés.
CreateMessage(MessageVersion, String, BodyWriter)	Crée un message avec un corps consistant en 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 contenant une erreur SOAP, une version et une action.
CreateMessage(MessageVersion, String, XmlDictionaryReader)	Crée un message avec la version, l'action et le corps spécifiés.
CreateMessage(MessageVersion, String)	Crée un message qui contient une version et une action.

Exemples

L'exemple de code suivant illustre un client qui utilise la fabrication de canal pour envoyer un message et en 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 permet de créer une copie d'un message en prévision de son envoi.

Lors de l'utilisation de messages JSON, faites appel à la méthode CreateMessage(MessageVersion, String, Object, XmlObjectSerializer) ; la méthode CreateMessage(MessageVersion, String, Object) 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, son motif et les informations relatives à 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

Motif de l'erreur SOAP.

detail: Object

Détails de l'erreur SOAP.

action: String

Décrit la manière dont le message doit être traité.

Retours

Message

Objet Message du message créé.

Exceptions

ArgumentNullException

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

Remarques

Cette méthode statique permet de créer une copie du 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, son motif, la 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

Motif de l'erreur SOAP.

action: String

Décrit la manière dont le message doit être traité.

Retours

Message

Objet Message du message créé.

Exceptions

ArgumentNullException

version, fault, action ou faultCode est null.

Remarques

Cette méthode statique permet de créer une copie du 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 de l'en-tête en octets.

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 la propriété de envelopeReader.

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

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

Le corps du message peut être lu à l'aide des méthodes GetBody sur le 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 de WriteBody ou WriteMessage. Une fois écrit, il ne peut pas être lu.

La fermeture du message entraîne la fermeture du lecteur d'enveloppe sous-jacent.

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 de l'en-tête en octets.

version: MessageVersion

Valeur MessageVersion correcte qui indique la version SOAP à utiliser pour le message.

Retours

Message

Objet Message du message créé.

Exceptions

ArgumentNullException

envelopeReader ou version est null.

Remarques

Message prend la propriété de envelopeReader.

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

La fermeture du message entraîne la fermeture du 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

Décrit la manière 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 permet de créer une copie du 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, l'action, le corps du message et le 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

Décrit la manière dont le message doit être traité.

body: Object

le corps du message.

serializer: XmlObjectSerializer

Objet de 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 permet de créer une copie du message prête pour l'envoi.

S’applique à

CreateMessage(MessageVersion, String, BodyWriter)

Source:: Message.cs

Source:: Message.cs

Source:: Message.cs

Crée un message avec un corps consistant en 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

Décrit la manière dont le message doit être traité.

body: BodyWriter

BodyWriter de type Byte.

Retours

Message

Objet Message du message créé.

Exceptions

ArgumentNullException

Version, action ou body est null.

Remarques

Un message vide peut être utilisé par un point de terminaison pour envoyer 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

Décrit la manière dont le message doit être traité.

body: Object

le corps du message.

Retours

Message

Objet Message du message créé.

Exceptions

ArgumentNullException

version, action ou body est null.

Remarques

Cette méthode statique permet de créer une copie du 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 contenant 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

Décrit la manière 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 permet de créer une copie du 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

Décrit la manière dont le message doit être traité.

body: XmlDictionaryReader

le corps du message.

Retours

Message

Objet Message du message créé.

Exceptions

ArgumentNullException

version, action ou body est null.

Remarques

Cette méthode statique permet de créer une copie du 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

Décrit la manière 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 permet de créer une copie du message prête pour l'envoi.

S’applique à

Message.CreateMessage Méthode

Définition

Surcharges

Exemples

Remarques

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

Paramètres

Retours

Exceptions

Remarques

S’applique à

CreateMessage(MessageVersion, FaultCode, String, String)

Paramètres

Retours

Exceptions

Remarques

S’applique à

CreateMessage(XmlReader, Int32, MessageVersion)

Paramètres

Retours

Exceptions

Remarques

S’applique à

CreateMessage(XmlDictionaryReader, Int32, MessageVersion)

Paramètres

Retours

Exceptions

Remarques

S’applique à

CreateMessage(MessageVersion, String, XmlReader)

Paramètres

Retours

Exceptions

Remarques

S’applique à

CreateMessage(MessageVersion, String, Object, XmlObjectSerializer)

Paramètres

Retours

Exceptions

Remarques

S’applique à

CreateMessage(MessageVersion, String, BodyWriter)

Paramètres

Retours

Exceptions

Remarques

S’applique à

CreateMessage(MessageVersion, String, Object)

Paramètres

Retours

Exceptions

Remarques

S’applique à

CreateMessage(MessageVersion, MessageFault, String)

Paramètres

Retours

Exceptions

Remarques

S’applique à

CreateMessage(MessageVersion, String, XmlDictionaryReader)

Paramètres

Retours

Exceptions

Remarques

S’applique à

CreateMessage(MessageVersion, String)

Paramètres

Retours

Exceptions

Remarques

S’applique à

Commentaires

Ressources supplémentaires