MtomMessageEncodingBindingElement Klasse

Definition

Das Bindungselement, das die für MTOM (Message Transmission Optimization Mechanism)-Nachrichten verwendete Codierung und Version angibt.

public ref class MtomMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement
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
public sealed class MtomMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement, System.ServiceModel.Description.IPolicyExportExtension, System.ServiceModel.Description.IWsdlExportExtension
type MtomMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement
type MtomMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement
    interface IWsdlExportExtension
    interface IPolicyExportExtension
Public NotInheritable Class MtomMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Public NotInheritable Class MtomMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Implements IPolicyExportExtension, IWsdlExportExtension
Vererbung
MtomMessageEncodingBindingElement
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).

Das MtomMessageEncodingBindingElement stellt das Bindungselement dar, das die Zeichencodierung und die für Nachrichten mit MTOM-Verschlüsselung (Message Transmission Optimization Mechanism) verwendete Nachrichtenversion und andere Einstellungen angibt. MTOM ist eine effiziente Technologie zum Übertragen von Binärdaten in WCF-Nachrichten. Der MTOM-Encoder versucht, einen Ausgleich zwischen Effizienz und Interoperabilität zu schaffen. Die MTOM-Verschlüsselung überträgt die meisten XML-Daten in Textform, optimiert aber große Binärdatenblöcke durch Übertragung ohne Konvertierung in ihr base64-verschlüsseltes Format.

Weitere Informationen zum Bindungselement, das angibt, dass Nachrichten mithilfe einer Textdarstellung von XML codiert werden, finden Sie unter TextMessageEncodingBindingElement.

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

Verwenden Sie die MessageEncodingBindingElement-Klasse, um einen benutzerdefinierten Nachrichtenencoder zu implementieren.

Konstruktoren

MtomMessageEncodingBindingElement()

Initialisiert eine neue Instanz der MtomMessageEncodingBindingElement-Klasse.

MtomMessageEncodingBindingElement(MessageVersion, Encoding)

Initialisiert eine neue Instanz der MtomMessageEncodingBindingElement-Klasse mit einer angegebenen Nachrichtenversion und Zeichencodierung.

Eigenschaften

MaxBufferSize

Ruft die maximale Puffergröße ab, oder legt diese fest.

MaxReadPoolSize

Ruft die maximale Anzahl an XML-Readern ab, die einem Pool zugeordnet sind und zum Verarbeiten eingehender Nachrichten bereit sind, oder legt diese Anzahl fest.

MaxWritePoolSize

Ruft die maximale Anzahl an XML-Writern ab, die einem Pool zugeordnet sind und zum Verarbeiten ausgehender Nachrichten verfügbar sind, oder legt diese Anzahl fest.

MessageVersion

Ruft die Versionen der SOAP-Nachricht und WS-Addressing ab, die verwendet oder erwartet werden, bzw. legt diese fest.

ReaderQuotas

Ruft Beschränkungen der Komplexität von XML-Nachrichten ab, die von mit diesem Bindungselement konfigurierten Endpunkten verarbeitet werden können, oder legt 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 Kanallistenerstapel auf dem Client, der einen angegebenen Kanaltyp für einen angegebenen 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 die aktuelle Bindung eine Factory für einen angegebenen Kanaltyp und Kontext erstellen kann.

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 MtomMessageEncodingBindingElement-Objekt.

CreateMessageEncoderFactory()

Erstellt eine Nachrichtenencoderfactory, die MTOM-Nachrichten verschlüsselt.

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)
ShouldSerializeMessageVersion()

Gibt zurück, ob die SOAP-Meldungsstrukturversion serialisiert werden soll.

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)

Fügt eine Richtlinienassertion in die WSDL ein, wenn sie erstellt wird, wodurch angegeben wird, dass eine MTOM-Codierung verwendet wird.

IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext)

Ändert den WSDL-Vertrag für MTOM-spezifische Informationen.

IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext)

Setzt die SOAP-Nachrichtenversion in die WSDL.

Gilt für: