BinaryMessageEncodingBindingElement Classe

Definizione

Elemento di associazione che specifica il formato binario .NET per XML utilizzato per codificare i messaggi.The binding element that specifies the .NET Binary Format for XML used to encode 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
Ereditarietà
BinaryMessageEncodingBindingElement
Implementazioni

Esempio

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)

Commenti

La codifica è il processo di trasformazione di un messaggio in una sequenza di byte.Encoding is the process of transforming a message into a sequence of bytes. La decodifica è il processo inverso.Decoding is the reverse process. Windows Communication Foundation (WCF) include tre tipi di codifica per i messaggi SOAP, ovvero testo, binaria e MTOM (Message Transmission Optimization Mechanism).Windows Communication Foundation (WCF) includes three types of encoding for SOAP messages: Text, Binary and Message Transmission Optimization Mechanism (MTOM).

BinaryMessageEncodingBindingElement è l'elemento di associazione che specifica che il formato binario .NET per XML deve essere utilizzato per la codifica dei messaggi.BinaryMessageEncodingBindingElement is the binding element that specifies that the .NET Binary Format for XML should be used for encoding messages. Sono disponibili opzioni per specificare la codifica dei caratteri e la versione SOAP e WS-Addressing da usare.It has options to specify the character encoding and the SOAP and WS-Addressing version to be used. La codifica binaria è la più efficiente ma la meno interoperativa delle opzioni di codifica.Binary encoding is the most efficient but least interoperable of the encoding options.

Per ulteriori informazioni sull'elemento di associazione che specifica che i messaggi vengono codificati utilizzando una rappresentazione testuale di XML, vedere TextMessageEncodingBindingElement .For more information about the binding element that specifies messages are encoded using a textual representation of XML, see TextMessageEncodingBindingElement.

Per ulteriori informazioni sull'elemento di associazione che specifica che i messaggi vengono codificati utilizzando la codifica dei messaggi MTOM, vedere MtomMessageEncodingBindingElement .For more information about the binding element that specifies messages are encoded using the MTOM message encoding, see MtomMessageEncodingBindingElement.

Per implementare un codificatore di messaggi personalizzato, utilizzare la classe MessageEncodingBindingElement.To implement a custom message encoder, use the MessageEncodingBindingElement class.

Costruttori

BinaryMessageEncodingBindingElement()

Inizializza una nuova istanza della classe BinaryMessageEncodingBindingElement.Initializes a new instance of the BinaryMessageEncodingBindingElement class.

Proprietà

CompressionFormat

Ottiene o imposta il formato di compressione per l'elemento di associazione.Gets or sets the compression format for the binding element.

MaxReadPoolSize

Ottiene o imposta il numero massimo di lettori XML allocati a un pool e che sono pronti per l'utilizzo per l'elaborazione dei messaggi in arrivo.Gets or sets the maximum number of XML readers that are allocated to a pool and are ready for use to process incoming messages.

MaxSessionSize

Ottiene o imposta la quantità massima di memoria disponibile in una sessione per l'ottimizzazione delle procedure di trasmissione.Gets or sets the maximum amount of memory available within a session for optimizing transmission procedures.

MaxWritePoolSize

Ottiene o imposta il numero massimo di writer XML allocati a un pool e disponibili per l'elaborazione di messaggi in uscita.Gets or sets the maximum number of XML writers that are allocated to a pool and are ready for use to process outgoing messages.

MessageVersion

Ottiene o imposta le versioni del messaggio SOAP e WS-Addressing utilizzate o previste.Gets or sets the SOAP message and WS-Addressing versions that are used or expected.

ReaderQuotas

Ottiene o imposta vincoli sulla complessità dei messaggi XML che possono essere elaborati dagli endpoint configurati con questo elemento di associazione.Gets or sets constraints on the complexity of XML messages that can be processed by endpoints configured with this binding element.

Metodi

BuildChannelFactory<TChannel>(BindingContext)

Compila lo stack della channel factory nel client che crea un tipo di canale specificato per un contesto specificato.Builds the channel factory stack on the client that creates a specified type of channel for a specified context.

BuildChannelListener<TChannel>(BindingContext)

Compila il listener del canale sul servizio che accetta un tipo di canale specificato per un contesto specificato.Builds the channel listener on the service that accepts a specified type of channel for a specified context.

BuildChannelListener<TChannel>(BindingContext)

Inizializza un listener del canale per accettare canali di un tipo specificato dal contesto dell'associazione.Initializes a channel listener to accept channels of a specified type from the binding context.

(Ereditato da BindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)

Restituisce un valore che indica se l'elemento di associazione può compilare una channel factory per un tipo di canale specifico.Returns a value that indicates whether the binding element can build a channel factory for a specific type of channel.

(Ereditato da BindingElement)
CanBuildChannelListener<TChannel>(BindingContext)

Restituisce un valore che indica se l'associazione corrente può compilare un listener per un tipo di canale e di contesto specificati.Returns a value that indicates whether the current binding can build a listener for a specified type of channel and context.

CanBuildChannelListener<TChannel>(BindingContext)

Restituisce un valore che indica se l'elemento di associazione può compilare un listener per un tipo di canale specifico.Returns a value that indicates whether the binding element can build a listener for a specific type of channel.

(Ereditato da BindingElement)
Clone()

Crea un nuovo oggetto BinaryMessageEncodingBindingElement inizializzato da quello corrente.Creates a new BinaryMessageEncodingBindingElement object initialized from the current one.

CreateMessageEncoderFactory()

Crea una factory per codificatori di messaggi binari che utilizzano le versioni SOAP e WS-Addressing e la codifica caratteri specificate dall'elemento di associazione della codifica corrente.Creates a factory for binary message encoders that employ the SOAP and WS-Addressing versions and the character encoding specified by the current encoding binding element.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetProperty<T>(BindingContext)

Se presente, restituisce un oggetto tipizzato richiesto dal livello appropriato nello stack dell'elemento di associazione.Returns a typed object requested, if present, from the appropriate layer in the binding element stack.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ShouldSerializeMessageVersion()

Restituisce un valore che indica se la versione della struttura del messaggio SOAP deve essere serializzata.Returns whether the SOAP message structure version should be serialized.

ShouldSerializeReaderQuotas()

Restituisce un valore che indica se i valori dei vincoli posizionati sulla complessità di struttura del messaggio SOAP devono essere serializzati.Returns whether the values of constraints placed on the complexity of SOAP message structure should be serialized.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext)

Scrive elementi di codifica di un messaggio binario personalizzato nei metadati generati per un endpoint.Writes a custom binary message encoding elements into the generated metadata for an endpoint.

IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext)

Scrive elementi di codifica di un messaggio binario personalizzato nel file WSDL generato per un contratto.Writes a custom binary message encoding elements into the generated WSDL for a contract.

IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext)

Scrive elementi di codifica di un messaggio binario personalizzato nel file WSDL generato per un endpoint.Writes a custom binary message encoding elements into the generated WSDL for an endpoint.

Si applica a