Message.CreateMessage Méthode

Définition

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.

C#
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();
        }
    }
}

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.

C#
public static System.ServiceModel.Channels.Message CreateMessage (System.ServiceModel.Channels.MessageVersion version, System.ServiceModel.FaultCode faultCode, string reason, object detail, string action);

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

Objet Message du message créé.

Exceptions

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 à

.NET Framework 4.8.1 et autres versions
Produit Versions
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

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.

C#
public static System.ServiceModel.Channels.Message CreateMessage (System.ServiceModel.Channels.MessageVersion version, System.ServiceModel.FaultCode faultCode, string reason, string action);

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

Objet Message du message créé.

Exceptions

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 à

.NET Framework 4.8.1 et autres versions
Produit Versions
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

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.

C#
public static System.ServiceModel.Channels.Message CreateMessage (System.Xml.XmlReader envelopeReader, int maxSizeOfHeaders, System.ServiceModel.Channels.MessageVersion version);

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

Objet Message du message créé.

Exceptions

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 à

.NET Core 1.1 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
UWP 10.0

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.

C#
public static System.ServiceModel.Channels.Message CreateMessage (System.Xml.XmlDictionaryReader envelopeReader, int maxSizeOfHeaders, System.ServiceModel.Channels.MessageVersion version);

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

Objet Message du message créé.

Exceptions

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 à

.NET Core 1.1 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
UWP 10.0

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.

C#
public static System.ServiceModel.Channels.Message CreateMessage (System.ServiceModel.Channels.MessageVersion version, string action, System.Xml.XmlReader body);

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

Objet Message du message créé.

Exceptions

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 à

.NET Core 1.1 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
UWP 10.0

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.

C#
public static System.ServiceModel.Channels.Message CreateMessage (System.ServiceModel.Channels.MessageVersion version, string action, object body, System.Runtime.Serialization.XmlObjectSerializer serializer);

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

Objet Message du message créé.

Exceptions

version, fault ou action est null.

Remarques

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

S’applique à

.NET Core 1.1 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
UWP 10.0

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.

C#
public static System.ServiceModel.Channels.Message CreateMessage (System.ServiceModel.Channels.MessageVersion version, string action, System.ServiceModel.Channels.BodyWriter body);

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

Objet Message du message créé.

Exceptions

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 à

.NET Core 1.1 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
UWP 10.0

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.

C#
public static System.ServiceModel.Channels.Message CreateMessage (System.ServiceModel.Channels.MessageVersion version, string action, object body);

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

Objet Message du message créé.

Exceptions

version, action ou body est null.

Remarques

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

S’applique à

.NET Core 1.1 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
UWP 10.0

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.

C#
public static System.ServiceModel.Channels.Message CreateMessage (System.ServiceModel.Channels.MessageVersion version, System.ServiceModel.Channels.MessageFault fault, string action);

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

Objet Message du message créé.

Exceptions

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 à

.NET Framework 4.8.1 et autres versions
Produit Versions
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

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.

C#
public static System.ServiceModel.Channels.Message CreateMessage (System.ServiceModel.Channels.MessageVersion version, string action, System.Xml.XmlDictionaryReader body);

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

Objet Message du message créé.

Exceptions

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 à

.NET Core 1.1 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
UWP 10.0

CreateMessage(MessageVersion, String)

Source:
Message.cs
Source:
Message.cs
Source:
Message.cs

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

C#
public static System.ServiceModel.Channels.Message CreateMessage (System.ServiceModel.Channels.MessageVersion version, string action);

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

Objet Message du message créé.

Exceptions

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 à

.NET Core 1.1 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
UWP 10.0