TextMessageEncodingBindingElement Classe

Definizione

Spazio dei nomi:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Pacchetto:

System.ServiceModel.Primitives v8.1.1

Origine:

netstandard.cs

Elemento di associazione che specifica la codifica dei caratteri e la versione dei messaggi utilizzate per i messaggi SOAP basati su testo.

public ref class TextMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement

public sealed class TextMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement

type TextMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement

Public NotInheritable Class TextMessageEncodingBindingElement
Inherits MessageEncodingBindingElement

Ereditarietà

Object

BindingElement

MessageEncodingBindingElement

TextMessageEncodingBindingElement

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, ovvero testo, binaria e MTOM (Message Transmission Optimization Mechanism).

La codifica di testo rappresentata dalla classe TextMessageEncodingBindingElement è la più interoperativa, ma la meno efficiente per i messaggi XML. In genere il servizio Web o il client di tale servizio è in grado di comprendere codice XML in formato testo. La trasmissione di grandi blocchi di dati binari in formato testo non è tuttavia efficiente.

Per altre informazioni sull'elemento di associazione che specifica che i messaggi vengono codificati usando il formato binario .NET per XML, vedere BinaryMessageEncodingBindingElement.

Per altre informazioni sull'elemento di associazione che specifica che i messaggi vengono codificati tramite la codifica dei messaggi MTOM, vedere MtomMessageEncodingBindingElement.

Per altre informazioni su come implementare un codificatore di messaggi personalizzato, usare la MessageEncodingBindingElement classe .

Costruttori

TextMessageEncodingBindingElement()	Inizializza una nuova istanza della classe TextMessageEncodingBindingElement.
TextMessageEncodingBindingElement(MessageVersion, Encoding)	Inizializza una nuova istanza della classe TextMessageEncodingBindingElement con una versione e una codifica messaggi specificate.

Proprietà

MessageVersion	Ottiene o imposta le versioni SOAP e WS-Addressing utilizzate per formattare il messaggio di testo.
ReaderQuotas	Ottiene o imposta vincoli sulla complessità dei messaggi SOAP che possono essere elaborati dagli endpoint configurati con questa associazione.
WriteEncoding	Ottiene o imposta la codifica utilizzata per formattare i caratteri nel testo del messaggio.

Metodi

BuildChannelFactory<TChannel>(BindingContext)	Compila lo stack della channel factory nel client che crea un tipo di canale specificato per un contesto specificato.
BuildChannelListener<TChannel>(BindingContext)	Inizializza un listener del canale per accettare canali di un tipo specificato dal contesto dell'associazione. (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. (Ereditato da BindingElement)
CanBuildChannelListener<TChannel>(BindingContext)	Restituisce un valore che indica se l'elemento di associazione può compilare un listener per un tipo di canale specifico. (Ereditato da BindingElement)
Clone()	Crea un nuovo oggetto TextMessageEncodingBindingElement inizializzato da quello corrente.
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.
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)	Se presente, restituisce un oggetto tipizzato richiesto dal livello appropriato nello stack dell'elemento di associazione.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)