Lire en anglais

Partager via


BinaryMessageEncodingBindingElement Classe

Définition

Élément de liaison qui spécifie le format binaire .NET pour XML utilisé pour encoder des messages.

C#
public sealed class BinaryMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement
C#
public sealed class BinaryMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement, System.ServiceModel.Description.IPolicyExportExtension, System.ServiceModel.Description.IWsdlExportExtension
Héritage
BinaryMessageEncodingBindingElement
Implémente

Exemples

C#
var be = new BinaryMessageEncodingBindingElement();
be.MaxReadPoolSize = 16;
be.MaxSessionSize = 2048;
be.MaxWritePoolSize = 16;
be.MessageVersion = MessageVersion.Default;
XmlDictionaryReaderQuotas quotas = be.ReaderQuotas;

var binding = new CustomBinding();
var bpCol = new BindingParameterCollection();
var context = new BindingContext(binding, bpCol);
be.BuildChannelFactory<IDuplexChannel>(context);

var binding2 = new CustomBinding();
var bpCol2 = new BindingParameterCollection();
var context2 = new BindingContext(binding2, bpCol2);
be.BuildChannelListener<IDuplexChannel>(context2);

be.CanBuildChannelListener<IDuplexChannel>(context2);
BindingElement bindingElement = be.Clone();
MessageEncoderFactory mef = be.CreateMessageEncoderFactory();
MessageVersion mv = be.GetProperty<MessageVersion>(context);

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).

BinaryMessageEncodingBindingElement est l’élément de liaison qui spécifie que le format binaire .NET pour XML doit être utilisé pour l’encodage des messages. Il dispose d’options permettant de spécifier l’encodage des caractères et la version SOAP et WS-Addressing à utiliser. L’encodage binaire est le plus efficace, mais le moins interopérable des options d’encodage.

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 que les messages sont encodés à l’aide de l’encodage de message MTOM, consultez MtomMessageEncodingBindingElement.

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

Constructeurs

BinaryMessageEncodingBindingElement()

Initialise une nouvelle instance de la classe BinaryMessageEncodingBindingElement.

Propriétés

CompressionFormat

Obtient ou définit le format de compression pour l'élément de liaison.

MaxReadPoolSize

Obtient ou définit le nombre maximal de lecteurs XML alloués à un pool et prêts à être utilisés pour traiter des messages entrants.

MaxSessionSize

Obtient ou définit la quantité de mémoire maximale disponible dans une session pour optimiser des procédures de transmission.

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 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.

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 l'écouteur de canal sur le service qui accepte un type de canal 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)

Retourne une valeur qui indique si l’élément de liaison peut générer une fabrication de canal pour un type de canal spécifique.

(Hérité de BindingElement)
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 BinaryMessageEncodingBindingElement initialisé à partir de l'objet actuel.

CreateMessageEncoderFactory()

Crée une fabrique d’encodeurs de messages binaires qui emploient les versions SOAP et WS-Addressing et l’encodage de caractères spécifiés par l’élément de liaison d’encodage actuel.

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 valeurs des contraintes placées sur la complexité de la structure du message SOAP doivent être sérialisées.

ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

Implémentations d’interfaces explicites

IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext)

Écrit des éléments d'encodage de message binaire personnalisé dans les métadonnées générées pour un point de terminaison.

IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext)

Écrit des éléments d'encodage de message binaire personnalisés dans le WSDL généré pour un contrat.

IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext)

Écrit des éléments d'encodage de message binaire personnalisés dans le WSDL généré pour un point de terminaison.

S’applique à

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