BinaryMessageEncodingBindingElement Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
O elemento de associação que especifica o formato binário .NET para XML usado para codificar mensagens.
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
- Herança
- Implementações
Exemplos
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)
Comentários
A codificação é o processo de transformação de uma mensagem em uma sequência de bytes. A decodificação é o processo inverso. O Windows Communication Foundation (WCF) inclui três tipos de codificação para mensagens SOAP: Mecanismo de Otimização de Transmissão de Mensagens, Binário e Binário (MTOM).
BinaryMessageEncodingBindingElement é o elemento de associação que especifica que o formato binário .NET para XML deve ser usado para codificar mensagens. Ele tem opções para especificar a codificação de caracteres e a versão SOAP e WS-Addressing a ser usada. A codificação binária é a mais eficiente, mas menos interoperável das opções de codificação.
Para obter mais informações sobre o elemento de associação que especifica que as mensagens são codificadas usando uma representação textual de XML, consulte TextMessageEncodingBindingElement.
Para obter mais informações sobre o elemento de associação que especifica que as mensagens são codificadas usando a codificação de mensagens MTOM, consulte MtomMessageEncodingBindingElement.
Para implementar um codificador de mensagens personalizado, use a MessageEncodingBindingElement classe.
Construtores
| Nome | Description |
|---|---|
| BinaryMessageEncodingBindingElement() |
Inicializa uma nova instância da classe BinaryMessageEncodingBindingElement. |
Propriedades
| Nome | Description |
|---|---|
| CompressionFormat |
Obtém ou define o formato de compactação para o elemento de associação. |
| MaxReadPoolSize |
Obtém ou define o número máximo de leitores XML alocados para um pool e estão prontos para uso para processar mensagens de entrada. |
| MaxSessionSize |
Obtém ou define a quantidade máxima de memória disponível em uma sessão para otimizar procedimentos de transmissão. |
| MaxWritePoolSize |
Obtém ou define o número máximo de gravadores XML que são alocados para um pool e estão prontos para uso para processar mensagens de saída. |
| MessageVersion |
Obtém ou define a mensagem SOAP e WS-Addressing versões que são usadas ou esperadas. |
| ReaderQuotas |
Obtém ou define restrições sobre a complexidade das mensagens XML que podem ser processadas por pontos de extremidade configurados com esse elemento de associação. |
Métodos
| Nome | Description |
|---|---|
| BuildChannelFactory<TChannel>(BindingContext) |
Cria a pilha de fábrica de canais no cliente que cria um tipo de canal especificado para um contexto especificado. |
| BuildChannelListener<TChannel>(BindingContext) |
Cria o ouvinte de canal no serviço que aceita um tipo de canal especificado para um contexto especificado. |
| CanBuildChannelFactory<TChannel>(BindingContext) |
Retorna um valor que indica se o elemento de associação pode criar uma fábrica de canais para um tipo específico de canal. (Herdado de BindingElement) |
| CanBuildChannelListener<TChannel>(BindingContext) |
Retorna um valor que indica se a associação atual pode criar um ouvinte para um tipo especificado de canal e contexto. |
| Clone() |
Cria um novo BinaryMessageEncodingBindingElement objeto inicializado do atual. |
| CreateMessageEncoderFactory() |
Cria uma fábrica para codificadores de mensagens binárias que empregam as versões SOAP e WS-Addressing e a codificação de caracteres especificada pelo elemento de associação de codificação atual. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como a função hash predefinida. (Herdado de Object) |
| GetProperty<T>(BindingContext) |
Retorna um objeto digitado solicitado, se presente, da camada apropriada na pilha de elementos de associação. |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| ShouldSerializeMessageVersion() |
Retorna se a versão da estrutura de mensagens SOAP deve ser serializada. |
| ShouldSerializeReaderQuotas() |
Retorna se os valores das restrições colocadas na complexidade da estrutura de mensagens SOAP devem ser serializados. |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext) |
Grava um elemento de codificação de mensagem binária personalizado nos metadados gerados para um ponto de extremidade. |
| IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext) |
Grava um elemento de codificação de mensagem binária personalizado no WSDL gerado para um contrato. |
| IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext) |
Grava um elemento de codificação de mensagem binária personalizado no WSDL gerado para um ponto de extremidade. |