TextMessageEncodingBindingElement Classe

Definizione

Elemento di associazione che specifica la codifica dei caratteri e la versione dei messaggi utilizzate per i messaggi SOAP basati su testo.The binding element that specifies the character encoding and message versioning used for text-based SOAP messages.

public ref class TextMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement
public ref class TextMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement, System::ServiceModel::Description::IPolicyExportExtension, System::ServiceModel::Description::IWsdlExportExtension
public sealed class TextMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement
public sealed class TextMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement, System.ServiceModel.Description.IPolicyExportExtension, System.ServiceModel.Description.IWsdlExportExtension
type TextMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement
type TextMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement
    interface IWsdlExportExtension
    interface IPolicyExportExtension
Public NotInheritable Class TextMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Public NotInheritable Class TextMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Implements IPolicyExportExtension, IWsdlExportExtension
Ereditarietà
TextMessageEncodingBindingElement
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 codifica di testo rappresentata dalla classe TextMessageEncodingBindingElement è la più interoperativa, ma la meno efficiente per i messaggi XML.The text encoding represented by the TextMessageEncodingBindingElement is the most interoperable, but the least efficient encoder for XML messages. In genere il servizio Web o il client di tale servizio è in grado di comprendere codice XML in formato testo.Web service or Web service client can generally understand textual XML. La trasmissione di grandi blocchi di dati binari in formato testo non è tuttavia efficiente.However, transmitting large blocks of binary data as text is not efficient.

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 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 ulteriori informazioni sull'implementazione di un codificatore di messaggi personalizzato, utilizzare la MessageEncodingBindingElement classe.For more information about how to implement a custom message encoder, use the MessageEncodingBindingElement class.

Costruttori

TextMessageEncodingBindingElement()

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

TextMessageEncodingBindingElement(MessageVersion, Encoding)

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

Proprietà

MaxReadPoolSize

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

MaxWritePoolSize

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

MessageVersion

Ottiene o imposta le versioni SOAP e WS-Addressing utilizzate per formattare il messaggio di testo.Gets or sets the SOAP and WS-Addressing versions that are used to format the text message.

ReaderQuotas

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

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 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 TextMessageEncodingBindingElement inizializzato da quello corrente.Creates a new TextMessageEncodingBindingElement object initialized from the current one.

CreateMessageEncoderFactory()

Crea una factory per codificatori di messaggi di testo che utilizzano la versione dei messaggi e la codifica dei caratteri specificate dall'elemento di associazione della codifica corrente.Creates a factory for text message encoders that employs the message version and 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)
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)

Genera informazioni di contratto WSDL da criteri di codifica contenuti nell'elemento di associazione.Generates WSDL contract information from encoding policies contained in the binding element.

IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext)

Genera informazioni di contratto WSDL da criteri di codifica contenuti nell'elemento di associazione.Generates WSDL contract information from encoding policies contained in the binding element.

IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext)

Genera informazioni di contratto WSDL da criteri di codifica contenuti nell'elemento di associazione.Generates WSDL contract information from encoding policies contained in the binding element.

Si applica a