BinaryMessageEncodingBindingElement Classe

Définition

Espace de noms:

System.ServiceModel.Channels

Assemblys:

System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Paquet:

System.ServiceModel.Primitives v10.0.652802

Source:

BinaryMessageEncodingBindingElement.cs

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

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

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

type BinaryMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement

Public NotInheritable Class BinaryMessageEncodingBindingElement
Inherits MessageEncodingBindingElement

Héritage

Object

BindingElement

MessageEncodingBindingElement

BinaryMessageEncodingBindingElement

Exemples

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

Dim be As New BinaryMessageEncodingBindingElement()
be.MaxReadPoolSize = 16
be.MaxSessionSize = 2048
be.MaxWritePoolSize = 16
be.MessageVersion = MessageVersion.Default
Dim quotas As XmlDictionaryReaderQuotas = be.ReaderQuotas

Dim binding As New CustomBinding()
Dim bpCol As New BindingParameterCollection()
Dim context As New BindingContext(binding, bpCol)
be.BuildChannelFactory(Of IDuplexChannel)(context)

Dim binding2 As New CustomBinding()
Dim bpCol2 As New BindingParameterCollection()
Dim context2 As New BindingContext(binding2, bpCol2)
be.BuildChannelListener(Of IDuplexChannel)(context2)

be.CanBuildChannelListener(Of IDuplexChannel)(context2)
Dim bindingElement As BindingElement = be.Clone()
Dim mef As MessageEncoderFactory = be.CreateMessageEncoderFactory()
Dim mv As MessageVersion = be.GetProperty(Of 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) comprend trois types d’encodage pour les messages SOAP : MTOM (Text, Binary and 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 pour spécifier l’encodage de 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 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 de l’encodage de message MTOM, consultez MtomMessageEncodingBindingElement.

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

Constructeurs

Nom	Description
BinaryMessageEncodingBindingElement()	Initialise une nouvelle instance de la classe BinaryMessageEncodingBindingElement.

Propriétés

Nom	Description
CompressionFormat	Obtient ou définit le format de compression de 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 les messages entrants.
MaxSessionSize	Obtient ou définit la quantité maximale de mémoire disponible dans une session pour optimiser les 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 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.

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é.
CanBuildChannelFactory<TChannel>(BindingContext)	Retourne une valeur qui indique si l’élément de liaison peut générer une fabrique de canaux pour un type spécifique de canal. (Hérité de BindingElement)
Clone()	Crée un BinaryMessageEncodingBindingElement objet initialisé à partir de celui en cours.
CreateMessageEncoderFactory()	Crée une fabrique pour les encodeurs de messages binaires qui utilisent les versions SOAP et WS-Addressing et l’encodage de caractères spécifié par l’élément de liaison d’encodage actuel.
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.