MessageVersion Classe

Définition

Espace de noms:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

Spécifie les versions de SOAP et WS-Addressing associées à un message et son échange.

public ref class MessageVersion sealed

public sealed class MessageVersion

[System.ComponentModel.TypeConverter(typeof(System.ServiceModel.Configuration.MessageVersionConverter))]
public sealed class MessageVersion

type MessageVersion = class

[<System.ComponentModel.TypeConverter(typeof(System.ServiceModel.Configuration.MessageVersionConverter))>]
type MessageVersion = class

Public NotInheritable Class MessageVersion

Héritage

Object

MessageVersion

Attributs

TypeConverterAttribute

Remarques

La MessageVersion contient les informations de contrôle de version à propos de l'enveloppe SOAP et du protocole d'adressage utilisé par un message. Une instance de Message est liée pendant la création à une MessageVersion spécifique en passant la version en tant que paramètre dans l'une des surcharges de CreateMessage.

Toutes les propriétés « get » statiques d'une classe, telles que Soap11WSAddressing10 et Soap12, présentent une sémantique de type énumération. Ils fournissent une énumération des versions de message possibles prises en charge par le runtime Windows Communication Foundation (WCF). Un message présente une structure pour son enveloppe et une structure d'adressage. MessageVersion correspond à un simple raccourci pour fournir en une seule fois {EnvelopeVersion, AddressingVersion}.

Il existe actuellement deux versions d'enveloppe SOAP disponibles : SOAP 1.1 et SOAP 1.2. Ces versions de SOAP sont représentées par l'objet EnvelopeVersion et sont retournées par les propriétés Soap11 et Soap12. La version de SOAP associée à l'objet MessageVersion peut être récupérée à l'aide de la propriété Envelope. Pour plus d’informations, consultez le schéma pour SOAP 1.1 et SOAP 1.2.

Deux versions de WS-Addressing sont actuellement disponibles : la version soumise le 10 août 2004 et la version spécifiée dans le protocole WS-Addressing 1.0. La version d'adresse utilisée par la version actuelle du message peut être récupérée à l'aide de la propriété Addressing. Ces versions de WS-Addressing sont représentées par AddressingVersion et sont retournées par les propriétés WSAddressingAugust2004 et WSAddressing10. La valeur héritée de la spécification WS-Addressing d'août 2004 a été conservée. La soumission des membres W3C du 10 août 2004 pour WS-Addressing est disponible sur l’adressage des services web (WS-Addressing). La recommandation du candidat W3C du 17 août 2005 pour WS-Addressing 1.0 - Core est disponible sur Web Services Addressing 1.0 - Core.

None prend en charge l’utilisation de la messagerie de type POX (Plain Old XML). L'activation de la messagerie POX de base se fait désormais simplement en paramétrant une liaison HTTP sur votre service avec un encodeur de texte qui utilise None.

Les objets de version du message peuvent être créés à l'aide des versions spécifiées de WS-Addressing et SOAP en utilisant une des surcharges de CreateVersion.

Propriétés

Addressing	Obtient ou définit la version de WS-Addressing qui est associée à la version actuelle du message.
Default	Obtient la version de message par défaut utilisée par Windows Communication Foundation (WCF).
Envelope	Obtient la version SOAP associée à la version actuelle du message.
None	Obtient la version du message qui n'utilise pas SOAP ni WS-Addressing.
Soap11	Obtient la version du message utilisant SOAP 1.1.
Soap11WSAddressing10	Obtient la version du message utilisant WS-Addressing 1.0 et SOAP 1.1.
Soap11WSAddressingAugust2004	Obtient la version du message utilisant la spécification WS-Addressing soumise le 10 août 2004 et SOAP 1.1.
Soap12	Obtient la version du message utilisant SOAP 1.2.
Soap12WSAddressing10	Obtient la version du message utilisant WS-Addressing 1.0 et SOAP 1.2.
Soap12WSAddressingAugust2004	Obtient la version du message utilisant la spécification WS-Addressing soumise en août 2004 et SOAP 1.2.

Méthodes

CreateVersion(EnvelopeVersion)	Crée un objet de la version du message en utilisant WS-Addressing 1.0 et une version SOAP spécifiée.
CreateVersion(EnvelopeVersion, AddressingVersion)	Crée un objet de la version du message avec les versions SOAP et WS-Addressing spécifiées.
Equals(Object)	Retourne une valeur qui indique si la version actuelle du message équivaut à un objet spécifié.
GetHashCode()	Obtient un code de hachage pour la version actuelle du message.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne la représentation sous forme de chaîne de la version de message actuelle.