TextMessageEncodingBindingElement Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Das Bindungselement, das die Zeichencodierung und die Nachrichtenversionsverwaltung angibt, die für textbasierte SOAP-Nachrichten verwendet wird.
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
- Implementiert
Hinweise
Die Codierung ist der Prozess der Transformation einer Nachricht in eine Folge von Bytes. Die Decodierung ist der umgekehrte Prozess. Windows Communication Foundation (WCF) enthält drei Arten von Codierung für SOAP-Nachrichten: Text, Binary and Message Transmission Optimization Mechanism (MTOM).
Die durch die TextMessageEncodingBindingElement Codierung dargestellte Textcodierung ist der interoperableste, aber der am wenigsten effiziente Encoder für XML-Nachrichten. Der Webdienst- oder Webdienstclient kann textbezogenes XML im Allgemeinen verstehen. Der Versand großer Binärdatenblöcke als Text ist jedoch nicht effizient.
Weitere Informationen zum Bindungselement, das Nachrichten angibt, werden mithilfe des .NET Binärformats für XML codiert, finden Sie unter BinaryMessageEncodingBindingElement.
Weitere Informationen zum Bindungselement, das Nachrichten angibt, werden mithilfe der MTOM-Nachrichtencodierung codiert, finden Sie unter MtomMessageEncodingBindingElement.
Weitere Informationen zum Implementieren eines benutzerdefinierten Nachrichten-Encoders verwenden Sie die MessageEncodingBindingElement Klasse.
Konstruktoren
| Name | Beschreibung |
|---|---|
| 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
| Name | Beschreibung |
|---|---|
| MaxReadPoolSize |
Dient zum Abrufen oder Festlegen der Anzahl der Leser, die einem Pool zugeordnet sind und bereit für die Verarbeitung eingehender Nachrichten sind. |
| MaxWritePoolSize |
Ruft die Anzahl der Autoren ab, die einem Pool zugeordnet sind, und kann für die Verarbeitung ausgehender Nachrichten verwendet werden, oder legt diese fest. |
| MessageVersion |
Ruft die SOAP- und WS-Addressing Versionen ab, die zum Formatieren der Textnachricht verwendet werden, oder legt sie fest. |
| ReaderQuotas |
Dient zum Abrufen oder Festlegen von Einschränkungen für die Komplexität von SOAP-Nachrichten, die von Endpunkten verarbeitet werden können, die mit dieser Bindung konfiguriert sind. |
| WriteEncoding |
Ruft die Codierung ab, die zum Formatieren der Zeichen in der Textnachricht verwendet wird, oder legt diese fest. |
Methoden
| Name | Beschreibung |
|---|---|
| BuildChannelFactory<TChannel>(BindingContext) |
Erstellt den Kanalfactorystapel auf dem Client, der einen bestimmten Kanaltyp für einen angegebenen Kontext erstellt. |
| BuildChannelListener<TChannel>(BindingContext) |
Erstellt den Kanallistener für den Dienst, der einen bestimmten Kanaltyp für einen bestimmten Kontext akzeptiert. |
| CanBuildChannelFactory<TChannel>(BindingContext) |
Gibt einen Wert zurück, der angibt, ob das Bindungselement eine Kanalfactory für einen bestimmten Kanaltyp erstellen kann. (Geerbt von BindingElement) |
| CanBuildChannelListener<TChannel>(BindingContext) |
Gibt einen Wert zurück, der angibt, ob die aktuelle Bindung einen Listener für einen bestimmten Kanal- und Kontexttyp erstellen kann. |
| Clone() |
Erstellt ein neues TextMessageEncodingBindingElement Objekt, das aus dem aktuellen objekt initialisiert wurde. |
| CreateMessageEncoderFactory() |
Erstellt eine Factory für Textnachrichten-Encoder, die die durch das aktuelle Codierungsbindungselement angegebene Nachrichtenversion und Zeichencodierung verwendet. |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetProperty<T>(BindingContext) |
Gibt ein typiertes Objekt zurück, das aus der entsprechenden Ebene im Bindungselementstapel angefordert wird, falls vorhanden. |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ShouldSerializeReaderQuotas() |
Gibt zurück, ob die Einschränkungen, die auf die Komplexität der SOAP-Nachrichtenstruktur platziert werden, serialisiert werden sollen. |
| ShouldSerializeWriteEncoding() |
Gibt zurück, ob das zum Formatieren der Encoding Nachrichtenzeichen verwendete Zeichen serialisiert werden soll. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext) |
Generiert WSDL-Vertragsinformationen aus Codierungsrichtlinien, die im Bindungselement enthalten sind. |
| IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext) |
Generiert WSDL-Vertragsinformationen aus Codierungsrichtlinien, die im Bindungselement enthalten sind. |
| IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext) |
Generiert WSDL-Vertragsinformationen aus Codierungsrichtlinien, die im Bindungselement enthalten sind. |