TextMessageEncodingBindingElement TextMessageEncodingBindingElement TextMessageEncodingBindingElement TextMessageEncodingBindingElement Class

Definition

Das Bindungselement, das die Zeichencodierung und Nachrichtenversion für textbasierte SOAP-Nachrichten angibt.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, System::ServiceModel::Description::IPolicyExportExtension, System::ServiceModel::Description::IWsdlExportExtension
public sealed class TextMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement, System.ServiceModel.Description.IPolicyExportExtension, System.ServiceModel.Description.IWsdlExportExtension
type TextMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement
    interface IWsdlExportExtension
    interface IPolicyExportExtension
Public NotInheritable Class TextMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Implements IPolicyExportExtension, IWsdlExportExtension
Vererbung
TextMessageEncodingBindingElementTextMessageEncodingBindingElementTextMessageEncodingBindingElementTextMessageEncodingBindingElement
Implementiert

Hinweise

Beim Codieren wird eine Nachricht in eine Bytefolge transformiert.Encoding is the process of transforming a message into a sequence of bytes. Beim Decodieren wird dieser Prozess umgekehrt.Decoding is the reverse process. Windows Communication Foundation (WCF) enthält drei Typen für die Codierung von SOAP-Nachrichten: Text, binär und Message Transmission Optimization Mechanism (MTOM).Windows Communication Foundation (WCF) includes three types of encoding for SOAP messages: Text, Binary and 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.The text encoding represented by the TextMessageEncodingBindingElement is the most interoperable, but the least efficient encoder for XML messages. Der Webdienst oder Webdienstclient kann im Allgemeinen Text-XML verstehen.Web service or Web service client can generally understand textual XML. Das Übermitteln umfangreicher Blöcke binärer Daten in Textform ist jedoch wenig effizient.However, transmitting large blocks of binary data as text is not efficient.

Weitere Informationen zu der Bindungselements, der angibt, Nachrichten mit verschlüsselt wurden das .NET Binary-Format für XML, finden Sie unter BinaryMessageEncodingBindingElement.For more information about the binding element that specifies messages are encoded using the .NET Binary Format for XML, see BinaryMessageEncodingBindingElement.

Weitere Informationen zu der Bindungselements, der angibt, werden Nachrichten codiert, mit der MTOM-nachrichtencodierung, finden Sie unter MtomMessageEncodingBindingElement.For more information about the binding element that specifies messages are encoded using the MTOM message encoding, see MtomMessageEncodingBindingElement.

Weitere Informationen dazu, wie Sie einen benutzerdefinierten Nachrichtenencoder zu implementieren, verwenden Sie die MessageEncodingBindingElement Klasse.For more information about how to implement a custom message encoder, use the MessageEncodingBindingElement class.

Konstruktoren

TextMessageEncodingBindingElement() TextMessageEncodingBindingElement() TextMessageEncodingBindingElement() TextMessageEncodingBindingElement()

Initialisiert eine neue Instanz der TextMessageEncodingBindingElement-Klasse.Initializes a new instance of the TextMessageEncodingBindingElement class.

TextMessageEncodingBindingElement(MessageVersion, Encoding) TextMessageEncodingBindingElement(MessageVersion, Encoding) TextMessageEncodingBindingElement(MessageVersion, Encoding) TextMessageEncodingBindingElement(MessageVersion, Encoding)

Initialisiert eine neue Instanz der TextMessageEncodingBindingElement-Klasse mit einer angegebenen Nachrichtenversion und -codierung.Initializes a new instance of the TextMessageEncodingBindingElement class with a specified message version and encoding.

Eigenschaften

MaxReadPoolSize MaxReadPoolSize MaxReadPoolSize MaxReadPoolSize

Ruft die Anzahl der Reader ab, die einem Pool zugeordnet und zum Verarbeiten eingehender Nachrichten verfügbar sind, oder legt diese Anzahl fest.Gets or sets the number of readers that are allocated to a pool and ready for use to process incoming messages.

MaxWritePoolSize MaxWritePoolSize MaxWritePoolSize MaxWritePoolSize

Ruft die Anzahl der Writer ab, die einem Pool zugeordnet und zum Verarbeiten ausgehender Nachrichten verfügbar sind, oder legt diese Anzahl fest.Gets or sets the number of writers that are allocated to a pool and ready for use to process outgoing messages.

MessageVersion MessageVersion MessageVersion MessageVersion

Ruft die SOAP- und WS-Addressing-Versionen ab, oder legt sie fest, die zum Formatieren der Textnachricht verwendet werden.Gets or sets the SOAP and WS-Addressing versions that are used to format the text message.

ReaderQuotas ReaderQuotas ReaderQuotas ReaderQuotas

Ruft Beschränkungen der Komplexität von SOAP-Nachrichten ab oder legt Beschränkungen fest, die von Endpunkten verarbeitet werden können, die mit dieser Bindung konfiguriert werden.Gets or sets constraints on the complexity of SOAP messages that can be processed by endpoints configured with this binding.

WriteEncoding WriteEncoding WriteEncoding WriteEncoding

Ruft die Codierung ab, oder legt sie fest, die zur Formatierung der Zeichen in der Textnachricht verwendet wird.Gets or sets the encoding that is used to format the characters in the text message.

Methoden

BuildChannelFactory<TChannel>(BindingContext) BuildChannelFactory<TChannel>(BindingContext) BuildChannelFactory<TChannel>(BindingContext) BuildChannelFactory<TChannel>(BindingContext)

Erstellt den Kanalfactorystapel auf dem Client, der einen angegebenen Kanaltyp für einen angegebenen Kontext erstellt.Builds the channel factory stack on the client that creates a specified type of channel for a specified context.

BuildChannelListener<TChannel>(BindingContext) BuildChannelListener<TChannel>(BindingContext) BuildChannelListener<TChannel>(BindingContext) BuildChannelListener<TChannel>(BindingContext)

Erstellt den Kanallistener auf dem Dienst, der einen festgelegten Kanaltyp für einen bestimmten Kontext akzeptiert.Builds the channel listener on the service that accepts a specified type of channel for a specified context.

CanBuildChannelFactory<TChannel>(BindingContext) CanBuildChannelFactory<TChannel>(BindingContext) CanBuildChannelFactory<TChannel>(BindingContext) 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.Returns a value that indicates whether the binding element can build a channel factory for a specific type of channel.

(Inherited from BindingElement)
CanBuildChannelListener<TChannel>(BindingContext) CanBuildChannelListener<TChannel>(BindingContext) CanBuildChannelListener<TChannel>(BindingContext) 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.Returns a value that indicates whether the current binding can build a listener for a specified type of channel and context.

Clone() Clone() Clone() Clone()

Erstellt ein neues, aus dem aktuellen Objekt initialisiertes TextMessageEncodingBindingElement-Objekt.Creates a new TextMessageEncodingBindingElement object initialized from the current one.

CreateMessageEncoderFactory() CreateMessageEncoderFactory() CreateMessageEncoderFactory() CreateMessageEncoderFactory()

Erstellt eine Factory für Textnachrichtenencoder, die die Nachrichtenversion und Zeichencodierung verwenden, die vom aktuellen Codierungsbindungselement festgelegt wurden.Creates a factory for text message encoders that employs the message version and character encoding specified by the current encoding binding element.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetProperty<T>(BindingContext) GetProperty<T>(BindingContext) GetProperty<T>(BindingContext) GetProperty<T>(BindingContext)

Gibt ggf. ein angefordertes typisiertes Objekt von der entsprechenden Ebene im Bindungselementstapel zurück.Returns a typed object requested, if present, from the appropriate layer in the binding element stack.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ShouldSerializeReaderQuotas() ShouldSerializeReaderQuotas() ShouldSerializeReaderQuotas() ShouldSerializeReaderQuotas()

Gibt zurück, ob die für die Komplexität der SOAP-Meldungsstruktur geltenden Einschränkungswerte serialisiert werden sollen.Returns whether the constraints placed on the complexity of SOAP message structure should be serialized.

ShouldSerializeWriteEncoding() ShouldSerializeWriteEncoding() ShouldSerializeWriteEncoding() ShouldSerializeWriteEncoding()

Gibt zurück, ob das Encoding-Objekt, das zum Formatieren der Meldungszeichen verwendet wird, serialisiert werden soll.Returns whether the Encoding that is used to format the message characters should be serialized.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Explizite Schnittstellenimplementierungen

IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext) IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext) IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext) IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext)

Generiert WSDL-Vertragsinformationen von im Bindungselement enthaltenen codierenden Richtlinien.Generates WSDL contract information from encoding policies contained in the binding element.

IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext) IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext) IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext) IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext)

Generiert WSDL-Vertragsinformationen von im Bindungselement enthaltenen codierenden Richtlinien.Generates WSDL contract information from encoding policies contained in the binding element.

IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext) IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext) IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext) IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext)

Generiert WSDL-Vertragsinformationen von im Bindungselement enthaltenen codierenden Richtlinien.Generates WSDL contract information from encoding policies contained in the binding element.

Gilt für: