Freigeben über


TextMessageEncodingBindingElement Klasse

Definition

Das Bindungselement, das die Zeichencodierung und Nachrichtenversion für textbasierte SOAP-Nachrichten angibt.

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
Vererbung
TextMessageEncodingBindingElement
Implementiert

Hinweise

Beim Codieren wird eine Nachricht in eine Bytefolge transformiert. Beim Decodieren wird dieser Prozess umgekehrt. Windows Communication Foundation (WCF) enthält drei Typen für die Codierung von SOAP-Nachrichten: Text, binär und Message Transmission Optimization Mechanism (MTOM).

Die vom TextMessageEncodingBindingElement dargestellte Textcodierung ist am besten für die Interoperabilität geeignet, jedoch der am wenigsten effektive Encoder für XML-Nachrichten. Der Webdienst oder Webdienstclient kann im Allgemeinen Text-XML verstehen. Das Übermitteln umfangreicher Blöcke binärer Daten in Textform ist jedoch wenig effizient.

Weitere Informationen zum Bindungselement, das angibt, dass Nachrichten mit dem .NET-Binärformat für XML codiert werden, finden Sie unter BinaryMessageEncodingBindingElement.

Weitere Informationen zum Bindungselement, das angibt, dass Nachrichten mithilfe der MTOM-Nachrichtencodierung codiert werden, finden Sie unter MtomMessageEncodingBindingElement.

Weitere Informationen zum Implementieren eines benutzerdefinierten Nachrichtenencoders finden Sie in der MessageEncodingBindingElement -Klasse.

Konstruktoren

TextMessageEncodingBindingElement()

Initialisiert eine neue Instanz der TextMessageEncodingBindingElement-Klasse.

TextMessageEncodingBindingElement(MessageVersion, Encoding)

Initialisiert eine neue Instanz der TextMessageEncodingBindingElement-Klasse mit einer angegebenen Nachrichtenversion und -codierung.

Eigenschaften

MaxReadPoolSize

Ruft die Anzahl der Reader ab, die einem Pool zugeordnet und zum Verarbeiten eingehender Nachrichten verfügbar sind, oder legt diese Anzahl fest.

MaxWritePoolSize

Ruft die Anzahl der Writer ab, die einem Pool zugeordnet und zum Verarbeiten ausgehender Nachrichten verfügbar sind, oder legt diese Anzahl fest.

MessageVersion

Ruft die SOAP- und WS-Addressing-Versionen ab, oder legt sie fest, die zum Formatieren der Textnachricht verwendet werden.

ReaderQuotas

Ruft Beschränkungen der Komplexität von SOAP-Meldungen ab, die von Endpunkten verarbeitet werden können, die mit dieser Bindung konfiguriert werden, oder legt die Beschränkungen fest.

WriteEncoding

Ruft die Codierung ab, oder legt sie fest, die zur Formatierung der Zeichen in der Textnachricht verwendet wird.

Methoden

BuildChannelFactory<TChannel>(BindingContext)

Erstellt den Kanalfactorystapel auf dem Client, der einen angegebenen Kanaltyp für einen angegebenen Kontext erstellt.

BuildChannelListener<TChannel>(BindingContext)

Erstellt den Kanallistener auf dem Dienst, der einen festgelegten Kanaltyp für einen bestimmten Kontext akzeptiert.

BuildChannelListener<TChannel>(BindingContext)

Initialisiert einen Kanallistener, der Kanäle eines bestimmten Typs aus dem Bindungskontext annimmt.

(Geerbt von BindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)

Gibt einen Wert zurück, der angibt, ob das Bindungselement eine Kanalfactory für einen bestimmten Typ von Kanälen erstellen kann.

(Geerbt von BindingElement)
CanBuildChannelListener<TChannel>(BindingContext)

Gibt einen Wert zurück, der angibt, ob die aktuelle Bindung einen Listener für einen angegebenen Typ von Kanal und Kontext erstellen kann.

CanBuildChannelListener<TChannel>(BindingContext)

Gibt einen Wert zurück, der angibt, ob das Bindungselement einen Listener für einen bestimmten Typ von Kanal erstellen kann.

(Geerbt von BindingElement)
Clone()

Erstellt ein neues, aus dem aktuellen Objekt initialisiertes TextMessageEncodingBindingElement-Objekt.

CreateMessageEncoderFactory()

Erstellt eine Factory für Textnachrichtenencoder, die die Nachrichtenversion und Zeichencodierung verwenden, die vom aktuellen Codierungsbindungselement festgelegt wurden.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetProperty<T>(BindingContext)

Gibt ggf. ein angefordertes typisiertes Objekt aus der entsprechenden Ebene im Bindungselementstapel zurück.

GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ShouldSerializeReaderQuotas()

Gibt zurück, ob die für die Komplexität der SOAP-Meldungsstruktur geltenden Einschränkungswerte serialisiert werden sollen.

ShouldSerializeWriteEncoding()

Gibt zurück, ob das Encoding-Objekt, das zum Formatieren der Meldungszeichen verwendet wird, serialisiert werden soll.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext)

Generiert WSDL-Vertragsinformationen aus im Bindungselement enthaltenen Codierungsrichtlinien.

IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext)

Generiert WSDL-Vertragsinformationen aus im Bindungselement enthaltenen Codierungsrichtlinien.

IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext)

Generiert WSDL-Vertragsinformationen aus im Bindungselement enthaltenen Codierungsrichtlinien.

Gilt für: