MtomMessageEncodingBindingElement Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Elemento di associazione che specifica la codifica e il controllo delle versioni utilizzati per i messaggi MTOM (Message Transmission Optimization Mechanism).
public ref class MtomMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement, System::ServiceModel::Description::IPolicyExportExtension, System::ServiceModel::Description::IWsdlExportExtensionpublic sealed class MtomMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement, System.ServiceModel.Description.IPolicyExportExtension, System.ServiceModel.Description.IWsdlExportExtensiontype MtomMessageEncodingBindingElement = class
inherit MessageEncodingBindingElement
interface IWsdlExportExtension
interface IPolicyExportExtensionPublic NotInheritable Class MtomMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Implements IPolicyExportExtension, IWsdlExportExtension- Ereditarietà
- Implementazioni
Commenti
La codifica è il processo di trasformazione di un messaggio in una sequenza di byte. La decodifica è il processo inverso. Windows Communication Foundation (WCF) include tre tipi di codifica per i messaggi SOAP: Text, Binary and Message Transmission Optimization Mechanism (MTOM).
MtomMessageEncodingBindingElement Rappresenta l'elemento di associazione che specifica la codifica dei caratteri e il controllo delle versioni dei messaggi e altre impostazioni utilizzate per i messaggi tramite una codifica MTOM (Message Transmission Optimization Mechanism). MTOM è una tecnologia efficiente per la trasmissione di dati binari nei messaggi WCF. Il codificatore MTOM tenta di creare un equilibrio tra efficienza e interoperabilità. La codifica MTOM trasmette la maggior parte dei dati XML in formato testuale, ma ottimizza grandi blocchi di dati binari trasmettendoli as-is, senza conversione nel formato con codifica Base64.
Per altre informazioni sull'elemento di associazione che specifica che i messaggi vengono codificati usando una rappresentazione testuale di XML, vedere TextMessageEncodingBindingElement.
Per altre informazioni sull'elemento di associazione che specifica che i messaggi vengono codificati usando il formato binario .NET per XML, vedere BinaryMessageEncodingBindingElement.
Per implementare un codificatore di messaggi personalizzato, usare la MessageEncodingBindingElement classe .
Costruttori
| Nome | Descrizione |
|---|---|
| MtomMessageEncodingBindingElement() |
Inizializza una nuova istanza della classe MtomMessageEncodingBindingElement. |
| MtomMessageEncodingBindingElement(MessageVersion, Encoding) |
Inizializza una nuova istanza della MtomMessageEncodingBindingElement classe con una versione del messaggio e una codifica dei caratteri specificati. |
Proprietà
| Nome | Descrizione |
|---|---|
| MaxBufferSize |
Ottiene o imposta la dimensione massima del buffer. |
| MaxReadPoolSize |
Ottiene o imposta il numero massimo di lettori XML allocati a un pool ed è pronto per l'elaborazione dei messaggi in ingresso. |
| MaxWritePoolSize |
Ottiene o imposta il numero massimo di writer XML allocati a un pool e pronti per l'elaborazione dei messaggi in uscita. |
| MessageVersion |
Ottiene o imposta il messaggio SOAP e WS-Addressing versioni utilizzate o previste. |
| ReaderQuotas |
Ottiene o imposta vincoli sulla complessità dei messaggi XML che possono essere elaborati dagli endpoint configurati con questo elemento di associazione. |
| WriteEncoding |
Ottiene o imposta la codifica utilizzata per formattare i caratteri nel messaggio di testo. |
Metodi
| Nome | Descrizione |
|---|---|
| BuildChannelFactory<TChannel>(BindingContext) |
Compila lo stack channel factory nel client che crea un tipo di canale specificato per un contesto specificato. |
| BuildChannelListener<TChannel>(BindingContext) |
Compila lo stack del listener del canale nel client che accetta un tipo di canale specificato per un contesto specificato. |
| CanBuildChannelFactory<TChannel>(BindingContext) |
Restituisce un valore che indica se l'associazione corrente può compilare una factory per un tipo specificato di canale e contesto. |
| CanBuildChannelListener<TChannel>(BindingContext) |
Restituisce un valore che indica se l'associazione corrente può compilare un listener per un tipo specificato di canale e contesto. |
| Clone() |
Crea un nuovo MtomMessageEncodingBindingElement oggetto inizializzato da quello corrente. |
| CreateMessageEncoderFactory() |
Crea una factory del codificatore di messaggi che codifica i messaggi MTOM. |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetProperty<T>(BindingContext) |
Restituisce un oggetto tipizzato richiesto, se presente, dal livello appropriato nello stack di elementi di associazione. |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| ShouldSerializeMessageVersion() |
Restituisce un valore che indica se la versione della struttura dei messaggi SOAP deve essere serializzata. |
| ShouldSerializeReaderQuotas() |
Restituisce un valore che indica se i vincoli posizionati sulla complessità della struttura dei messaggi SOAP devono essere serializzati. |
| ShouldSerializeWriteEncoding() |
Restituisce un valore che indica se l'oggetto Encoding utilizzato per formattare i caratteri del messaggio deve essere serializzato. |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext) |
Inserisce un'asserzione di criteri nel file WSDL, quando viene generata, che indica che viene usata una codifica MTOM. |
| IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext) |
Modifica il contratto WSDL per informazioni specifiche di MTOM. |
| IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext) |
Inserisce la versione del messaggio SOAP in WSDL. |