MtomMessageEncodingBindingElement Classe

Definizione

Elemento di associazione che specifica la codifica dei caratteri e la versione dei messaggi utilizzate per i messaggi MTOM (Message Transmission Optimization Mechanism).The binding element that specifies the encoding and versioning used for Message Transmission Optimization Mechanism (MTOM) messages.

public ref class MtomMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement, System::ServiceModel::Description::IPolicyExportExtension, System::ServiceModel::Description::IWsdlExportExtension
public sealed class MtomMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement, System.ServiceModel.Description.IPolicyExportExtension, System.ServiceModel.Description.IWsdlExportExtension
type MtomMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement
    interface IWsdlExportExtension
    interface IPolicyExportExtension
Public NotInheritable Class MtomMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Implements IPolicyExportExtension, IWsdlExportExtension
Ereditarietà
MtomMessageEncodingBindingElement
Implementazioni

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

La classe MtomMessageEncodingBindingElement rappresenta l'elemento di associazione che specifica la codifica dei caratteri, la versione dei messaggi e altre impostazioni utilizzate per i messaggi che utilizzano la codifica MTOM (Message Transmission Optimization Mechanism).The MtomMessageEncodingBindingElement represents the binding element that specifies the character encoding and message versioning and other settings used for messages using a Message Transmission Optimization Mechanism (MTOM) encoding. MTOM è una tecnologia efficiente per la trasmissione di dati binari nei messaggi di WCF.MTOM is an efficient technology for transmitting binary data in WCF messages. Il codificatore MTOM cerca di creare un equilibrio tra efficienza e interoperabilità.The MTOM encoder attempts to create a balance between efficiency and interoperability. La codifica MTOM trasmette la maggior parte del codice XML in formato testo, ma ottimizza grandi blocchi di dati binari trasmettendoli senza introdurre modifiche e senza convertirli nel formato codificato Base64.The MTOM encoding transmits most XML in textual form, but optimizes large blocks of binary data by transmitting them as-is, without conversion to their base64 encoded format.

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 that 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 il formato binario .NET per XML, vedere BinaryMessageEncodingBindingElement .For more information about the binding element that specifies messages are encoded using the .NET Binary Format for XML, see BinaryMessageEncodingBindingElement.

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

Costruttori

MtomMessageEncodingBindingElement()

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

MtomMessageEncodingBindingElement(MessageVersion, Encoding)

Inizializza una nuova istanza della classe MtomMessageEncodingBindingElement con una versione messaggi e una codifica caratteri specificate.Initializes a new instance of the MtomMessageEncodingBindingElement class with a specified message version and character encoding.

Proprietà

MaxBufferSize

Ottiene o imposta la dimensione massima del buffer.Gets or sets the maximum buffer size.

MaxReadPoolSize

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

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 is 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.

WriteEncoding

Ottiene o imposta la codifica utilizzata per formattare i caratteri nel testo del messaggio.Gets or sets the encoding that is used to format the characters in the text message.

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 lo stack del listener del canale nel client che accetta un tipo di canale specificato per un contesto specificato.Builds the channel listener stack on the client that accepts a specified type of channel for a specified context.

CanBuildChannelFactory<TChannel>(BindingContext)

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

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.

Clone()

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

CreateMessageEncoderFactory()

Crea una factory di codificatore di messaggi che codifica messaggi MTOM.Creates a message encoder factory that encodes MTOM messages.

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 devono essere serializzati i vincoli posizionati sulla complessità di struttura del messaggio SOAP.Returns whether the constraints placed on the complexity of SOAP message structure should be serialized.

ShouldSerializeWriteEncoding()

Indica se l'oggetto Encoding utilizzato per formattare i caratteri del messaggio deve essere serializzato.Returns whether the Encoding that is used to format the message characters 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)

Inserisce un'asserzione di criteri nel file WSDL, quando questo viene generato, che indica che viene utilizzata una codifica MTOM.Inserts a policy assertion into the WSDL, when it is generated, which indicates that an MTOM encoding is being used.

IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext)

Modifica il contratto WSDL per informazioni specifiche della codifica MTOM.Modifies the WSDL contract for MTOM-specific information.

IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext)

Converte la versione del messaggio SOAP in formato WSDL.Puts the SOAP message version into the WSDL.

Si applica a