MtomMessageEncodingBindingElement Classe

Définition

Espace de noms:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

Élément de liaison qui spécifie l’encodage et le versioning utilisés pour les messages MTOM (Message Transmission Optimization Mechanism).

public ref class MtomMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement

public ref class MtomMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement, System::ServiceModel::Description::IPolicyExportExtension, System::ServiceModel::Description::IWsdlExportExtension

public sealed class MtomMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement

public sealed class MtomMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement, System.ServiceModel.Description.IPolicyExportExtension, System.ServiceModel.Description.IWsdlExportExtension

type MtomMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement

type MtomMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement
    interface IWsdlExportExtension
    interface IPolicyExportExtension

Public NotInheritable Class MtomMessageEncodingBindingElement
Inherits MessageEncodingBindingElement

Public NotInheritable Class MtomMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Implements IPolicyExportExtension, IWsdlExportExtension

Héritage

Object

BindingElement

MessageEncodingBindingElement

MtomMessageEncodingBindingElement

Implémente

IPolicyExportExtension IWsdlExportExtension

Remarques

L'encodage est le processus de transformation d'un message en une séquence d'octets. Le décodage est le processus inverse. Windows Communication Foundation (WCF) inclut trois types d'encodage des messages SOAP : Texte, Binaire et MTOM (Message Transmission Optimization Mechanism).

MtomMessageEncodingBindingElement représente l'élément de liaison qui spécifie l'encodage de caractères et le versioning de message ainsi que d'autres paramètres utilisés pour un message encodé avec MTOM (Message Transmission Optimization Mechanism). MTOM est une technologie efficace de transmission de données binaires dans les messages WCF. L'encodeur MTOM tente de créer un équilibre entre rendement et interopérabilité. L'encodage MTOM transmet la plupart des données XML sous forme textuelle, mais optimise les blocs de données binaires volumineux en les transmettant tels quels, sans conversion au format base64 encodé.

Pour plus d’informations sur l’élément de liaison qui spécifie que les messages sont encodés à l’aide d’une représentation textuelle de XML, voir TextMessageEncodingBindingElement.

Pour plus d’informations sur l’élément de liaison qui spécifie les messages sont encodés à l’aide du format binaire .NET pour XML, voir BinaryMessageEncodingBindingElement.

Pour implémenter un encodeur de message personnalisé, utilisez la classe MessageEncodingBindingElement.

Constructeurs

MtomMessageEncodingBindingElement()	Initialise une nouvelle instance de la classe MtomMessageEncodingBindingElement.
MtomMessageEncodingBindingElement(MessageVersion, Encoding)	Initialise une nouvelle instance de la classe MtomMessageEncodingBindingElement avec spécification de l'encodage de caractères et de la version du message.

Propriétés

MaxBufferSize	Obtient ou définit la taille maximale de la mémoire tampon.
MaxReadPoolSize	Obtient ou définit le nombre maximal de lecteurs XML alloués à un pool et prêts à servir au traitement des messages entrants.
MaxWritePoolSize	Obtient ou définit le nombre maximal d'enregistreurs XML alloués à un pool et prêts à servir au traitement des messages sortants.
MessageVersion	Obtient ou définit le message SOAP et les versions WS-Addressing qui sont utilisées ou attendues.
ReaderQuotas	Obtient ou définit des contraintes sur la complexité des messages XML pouvant être traités par les points de terminaison configurés avec cet élément de liaison.
WriteEncoding	Obtient ou définit l'encodage utilisé pour mettre en forme les caractères contenus dans le message texte.

Méthodes

BuildChannelFactory<TChannel>(BindingContext)	Génère la pile de fabrications de canal sur le client effectuant la création d'un type de canaux spécifié pour un contexte spécifié.
BuildChannelListener<TChannel>(BindingContext)	Génère la pile d'écouteurs de canal sur le client acceptant un type de canaux spécifié pour un contexte spécifié.
BuildChannelListener<TChannel>(BindingContext)	Initialise un écouteur de canal pour accepter les canaux d’un type donné issus du contexte de liaison. (Hérité de BindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)	Renvoie une valeur indiquant si la liaison actuelle peut générer une fabrique pour un type spécifique de contexte et de canal.
CanBuildChannelListener<TChannel>(BindingContext)	Renvoie une valeur indiquant si l'élément de liaison en cours peut générer un écouteur pour un type spécifique de contexte et de canal.
CanBuildChannelListener<TChannel>(BindingContext)	Retourne une valeur qui indique si l’élément de liaison peut générer un écouteur pour un type de canal spécifique. (Hérité de BindingElement)
Clone()	Crée un objet MtomMessageEncodingBindingElement initialisé à partir de l'objet actuel.
CreateMessageEncoderFactory()	Crée une fabrique d'encodeurs de message qui encode les messages MTOM.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetProperty<T>(BindingContext)	Retourne un objet typé demandé (s'il existe) à partir de la couche appropriée de la pile des éléments de liaison.
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)
ShouldSerializeMessageVersion()	Retourne une valeur indiquant si la version de la structure du message SOAP doit être sérialisée.
ShouldSerializeReaderQuotas()	Retourne une valeur indiquant si les contraintes placées sur la complexité de la structure des messages SOAP doivent être sérialisées.
ShouldSerializeWriteEncoding()	Retourne une valeur indiquant si l'objet Encoding utilisé pour mettre en forme les caractères de message doit être sérialisé.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext)	Insère une assertion de stratégie dans le WSDL, lorsqu'il est généré, qui indique qu'un encodage MTOM est utilisé.
IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext)	Modifie le contrat WSDL pour les informations spécifiques au MTOM.
IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext)	Met la version du message SOAP dans le WSDL.