MtomMessageEncodingBindingElement Classe
Définition
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.
Élément de liaison qui spécifie l’encodage et le contrôle de version utilisés pour les messages MTOM (Message Transmission Optimization Mechanism).
public ref class MtomMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElementpublic ref class MtomMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement, System::ServiceModel::Description::IPolicyExportExtension, System::ServiceModel::Description::IWsdlExportExtensionpublic sealed class MtomMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElementpublic sealed class MtomMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement, System.ServiceModel.Description.IPolicyExportExtension, System.ServiceModel.Description.IWsdlExportExtensiontype MtomMessageEncodingBindingElement = class
inherit MessageEncodingBindingElementtype MtomMessageEncodingBindingElement = class
inherit MessageEncodingBindingElement
interface IWsdlExportExtension
interface IPolicyExportExtensionPublic NotInheritable Class MtomMessageEncodingBindingElement
Inherits MessageEncodingBindingElementPublic NotInheritable Class MtomMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Implements IPolicyExportExtension, IWsdlExportExtension- Héritage
- Implémente
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) comprend trois types d’encodage pour les messages SOAP : MTOM (Text, Binary and Message Transmission Optimization Mechanism).
Représente MtomMessageEncodingBindingElement l’élément de liaison qui spécifie l’encodage de caractères et le contrôle de version des messages et d’autres paramètres utilisés pour les messages à l’aide d’un encodage MTOM (Message Transmission Optimization Mechanism). MTOM est une technologie efficace pour transmettre des données binaires dans des messages WCF. L’encodeur MTOM tente de créer un équilibre entre efficacité et interopérabilité. L’encodage MTOM transmet la plupart des données XML sous forme textuelle, mais optimise les grands blocs de données binaires en les transmettant as-is, sans conversion au format codé en base64.
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, consultez 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, consultez BinaryMessageEncodingBindingElement.
Pour implémenter un encodeur de message personnalisé, utilisez la MessageEncodingBindingElement classe.
Constructeurs
| Nom | Description |
|---|---|
| MtomMessageEncodingBindingElement() |
Initialise une nouvelle instance de la classe MtomMessageEncodingBindingElement. |
| MtomMessageEncodingBindingElement(MessageVersion, Encoding) |
Initialise une nouvelle instance de la MtomMessageEncodingBindingElement classe avec une version de message et un encodage de caractères spécifiés. |
Propriétés
| Nom | Description |
|---|---|
| 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 est prêt à être utilisé pour traiter les messages entrants. |
| MaxWritePoolSize |
Obtient ou définit le nombre maximal d’enregistreurs XML alloués à un pool et prêts à être utilisés pour traiter les messages sortants. |
| MessageVersion |
Obtient ou définit le message SOAP et WS-Addressing versions utilisées ou attendues. |
| ReaderQuotas |
Obtient ou définit des contraintes sur la complexité des messages XML qui peuvent ê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 dans le message texte. |
Méthodes
| Nom | Description |
|---|---|
| BuildChannelFactory<TChannel>(BindingContext) |
Génère la pile de fabrique de canaux sur le client qui crée un type de canal spécifié pour un contexte spécifié. |
| BuildChannelListener<TChannel>(BindingContext) |
Génère la pile de l’écouteur de canal sur le client qui accepte un type de canal spécifié pour un contexte spécifié. |
| CanBuildChannelFactory<TChannel>(BindingContext) |
Retourne une valeur qui indique si la liaison actuelle peut générer une fabrique pour un type de canal et de contexte spécifié. |
| CanBuildChannelListener<TChannel>(BindingContext) |
Retourne une valeur qui indique si la liaison actuelle peut générer un écouteur pour un type de canal et de contexte spécifié. |
| Clone() |
Crée un MtomMessageEncodingBindingElement objet initialisé à partir de celui en cours. |
| CreateMessageEncoderFactory() |
Crée une fabrique d’encodeur 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() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetProperty<T>(BindingContext) |
Retourne un objet typé demandé, le cas échéant, à partir de la couche appropriée dans la pile d’éléments de liaison. |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| ShouldSerializeMessageVersion() |
Retourne si la version de la structure de message SOAP doit être sérialisée. |
| ShouldSerializeReaderQuotas() |
Retourne si les contraintes placées sur la complexité de la structure de messages SOAP doivent être sérialisées. |
| ShouldSerializeWriteEncoding() |
Retourne si l’élément Encoding utilisé pour mettre en forme les caractères du 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
| Nom | Description |
|---|---|
| IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext) |
Insère une assertion de stratégie dans WSDL, lorsqu’elle est générée, ce qui indique qu’un encodage MTOM est utilisé. |
| IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext) |
Modifie le contrat WSDL pour les informations spécifiques à MTOM. |
| IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext) |
Place la version du message SOAP dans WSDL. |
