BinaryMessageEncodingBindingElement Clase

Definición

Espacio de nombres:

System.ServiceModel.Channels

Ensamblado:

System.ServiceModel.dll

Elemento de enlace que especifica el formato binario de .NET para XML que se usa para codificar mensajes.

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, System.ServiceModel.Description.IPolicyExportExtension, System.ServiceModel.Description.IWsdlExportExtension

type BinaryMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement
    interface IWsdlExportExtension
    interface IPolicyExportExtension

Public NotInheritable Class BinaryMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Implements IPolicyExportExtension, IWsdlExportExtension

Herencia

Object

BindingElement

MessageEncodingBindingElement

BinaryMessageEncodingBindingElement

Implementaciones

IPolicyExportExtension IWsdlExportExtension

Ejemplos

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)

Comentarios

La codificación es el proceso de transformar un mensaje en una secuencia de bytes. La descodificación es el proceso inverso. Windows Communication Foundation (WCF) incluye tres tipos de codificación para mensajes SOAP: Text, Binary and Message Transmission Optimization Mechanism (MTOM).

BinaryMessageEncodingBindingElement es el elemento de enlace que especifica que el formato binario .NET para XML debe usarse para codificar mensajes. Tiene opciones para especificar la codificación de caracteres y la versión soap y WS-Addressing que se va a usar. La codificación binaria es la más eficaz pero menos interoperable de las opciones de codificación.

Para obtener más información sobre el elemento de enlace que especifica que los mensajes se codifican mediante una representación textual de XML, vea TextMessageEncodingBindingElement.

Para obtener más información sobre el elemento de enlace que especifica que los mensajes se codifican mediante la codificación de mensajes MTOM, vea MtomMessageEncodingBindingElement.

Para implementar un codificador de mensajes personalizado, use la MessageEncodingBindingElement clase .

Constructores

Nombre	Description
BinaryMessageEncodingBindingElement()	Inicializa una nueva instancia de la clase BinaryMessageEncodingBindingElement.

Propiedades

Nombre	Description
CompressionFormat	Obtiene o establece el formato de compresión para el elemento de enlace.
MaxReadPoolSize	Obtiene o establece el número máximo de lectores XML asignados a un grupo y listos para su uso para procesar los mensajes entrantes.
MaxSessionSize	Obtiene o establece la cantidad máxima de memoria disponible en una sesión para optimizar los procedimientos de transmisión.
MaxWritePoolSize	Obtiene o establece el número máximo de escritores XML que se asignan a un grupo y están listos para su uso para procesar los mensajes salientes.
MessageVersion	Obtiene o establece el mensaje SOAP y WS-Addressing versiones que se usan o esperan.
ReaderQuotas	Obtiene o establece restricciones sobre la complejidad de los mensajes XML que los puntos de conexión configurados con este elemento de enlace pueden procesar.

Métodos

Nombre	Description
BuildChannelFactory<TChannel>(BindingContext)	Compila la pila del generador de canales en el cliente que crea un tipo de canal especificado para un contexto especificado.
BuildChannelListener<TChannel>(BindingContext)	Compila el agente de escucha del canal en el servicio que acepta un tipo de canal especificado para un contexto especificado.
CanBuildChannelFactory<TChannel>(BindingContext)	Devuelve un valor que indica si el elemento de enlace puede crear un generador de canales para un tipo específico de canal. (Heredado de BindingElement)
CanBuildChannelListener<TChannel>(BindingContext)	Devuelve un valor que indica si el enlace actual puede crear un agente de escucha para un tipo especificado de canal y contexto.
Clone()	Crea un nuevo BinaryMessageEncodingBindingElement objeto inicializado a partir del actual.
CreateMessageEncoderFactory()	Crea un generador para codificadores de mensajes binarios que emplean las versiones SOAP y WS-Addressing y la codificación de caracteres especificada por el elemento de enlace de codificación actual.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetHashCode()	Actúa como la función hash predeterminada. (Heredado de Object)
GetProperty<T>(BindingContext)	Devuelve un objeto con tipo solicitado, si está presente, de la capa adecuada en la pila de elementos de enlace.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
ShouldSerializeMessageVersion()	Devuelve si se debe serializar la versión de la estructura de mensajes SOAP.
ShouldSerializeReaderQuotas()	Devuelve si se deben serializar los valores de las restricciones colocadas en la complejidad de la estructura de mensajes SOAP.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

Nombre	Description
IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext)	Escribe un elemento de codificación de mensajes binarios personalizado en los metadatos generados para un punto de conexión.
IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext)	Escribe un elemento de codificación de mensajes binarios personalizado en el WSDL generado para un contrato.
IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext)	Escribe un elemento de codificación de mensajes binarios personalizado en el WSDL generado para un punto de conexión.