BinaryMessageEncodingBindingElement Classe

Référence

Définition

Espace de noms:: System.ServiceModel.Channels

Assembly:: System.ServiceModel.Primitives.dll

Assembly:: System.ServiceModel.dll

Paquet:: System.ServiceModel.Primitives v6.0.0

Paquet:: System.ServiceModel.Primitives v6.2.0

Paquet:: System.ServiceModel.Primitives v8.0.0

Source:: BinaryMessageEncodingBindingElement.cs

Source:: BinaryMessageEncodingBindingElement.cs

Source:: BinaryMessageEncodingBindingElement.cs

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 le format binaire .NET pour XML utilisé pour encoder des messages.

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

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

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

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

type BinaryMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement

type BinaryMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement
    interface IWsdlExportExtension
    interface IPolicyExportExtension

Public NotInheritable Class BinaryMessageEncodingBindingElement
Inherits MessageEncodingBindingElement

Public NotInheritable Class BinaryMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Implements IPolicyExportExtension, IWsdlExportExtension

Héritage: Object

BindingElement

MessageEncodingBindingElement
BinaryMessageEncodingBindingElement

Implémente: IPolicyExportExtension IWsdlExportExtension

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