BinaryMessageEncodingBindingElement 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 das .NET Binary Format für XML angibt, das zum Codieren von Nachrichten verwendet wird.
public ref class BinaryMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement
public ref class BinaryMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement, System::ServiceModel::Description::IPolicyExportExtension, System::ServiceModel::Description::IWsdlExportExtension
public sealed class BinaryMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement
public sealed class BinaryMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement, System.ServiceModel.Description.IPolicyExportExtension, System.ServiceModel.Description.IWsdlExportExtension
type BinaryMessageEncodingBindingElement = class
inherit MessageEncodingBindingElement
type BinaryMessageEncodingBindingElement = class
inherit MessageEncodingBindingElement
interface IWsdlExportExtension
interface IPolicyExportExtension
Public NotInheritable Class BinaryMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Public NotInheritable Class BinaryMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Implements IPolicyExportExtension, IWsdlExportExtension
- Vererbung
- Implementiert
Beispiele
var be = new BinaryMessageEncodingBindingElement();
be.MaxReadPoolSize = 16;
be.MaxSessionSize = 2048;
be.MaxWritePoolSize = 16;
be.MessageVersion = MessageVersion.Default;
XmlDictionaryReaderQuotas quotas = be.ReaderQuotas;
var binding = new CustomBinding();
var bpCol = new BindingParameterCollection();
var context = new BindingContext(binding, bpCol);
be.BuildChannelFactory<IDuplexChannel>(context);
var binding2 = new CustomBinding();
var bpCol2 = new BindingParameterCollection();
var context2 = new BindingContext(binding2, bpCol2);
be.BuildChannelListener<IDuplexChannel>(context2);
be.CanBuildChannelListener<IDuplexChannel>(context2);
BindingElement bindingElement = be.Clone();
MessageEncoderFactory mef = be.CreateMessageEncoderFactory();
MessageVersion mv = be.GetProperty<MessageVersion>(context);
Dim be As New BinaryMessageEncodingBindingElement()
be.MaxReadPoolSize = 16
be.MaxSessionSize = 2048
be.MaxWritePoolSize = 16
be.MessageVersion = MessageVersion.Default
Dim quotas As XmlDictionaryReaderQuotas = be.ReaderQuotas
Dim binding As New CustomBinding()
Dim bpCol As New BindingParameterCollection()
Dim context As New BindingContext(binding, bpCol)
be.BuildChannelFactory(Of IDuplexChannel)(context)
Dim binding2 As New CustomBinding()
Dim bpCol2 As New BindingParameterCollection()
Dim context2 As New BindingContext(binding2, bpCol2)
be.BuildChannelListener(Of IDuplexChannel)(context2)
be.CanBuildChannelListener(Of IDuplexChannel)(context2)
Dim bindingElement As BindingElement = be.Clone()
Dim mef As MessageEncoderFactory = be.CreateMessageEncoderFactory()
Dim mv As MessageVersion = be.GetProperty(Of MessageVersion)(context)
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).
BinaryMessageEncodingBindingElement ist das Bindungselement, das angibt, dass das .NET Binärformat für XML zum Codieren von Nachrichten verwendet werden soll. Es verfügt über Optionen zum Angeben der Zeichencodierung und der SOAP und WS-Addressing Version, die verwendet werden soll. Binäre Codierung ist die effizienteste, aber am wenigsten interoperable Codierungsoptionen.
Weitere Informationen zum Bindungselement, das Nachrichten angibt, werden mithilfe einer Textdarstellung von XML codiert. Weitere Informationen finden Sie unter TextMessageEncodingBindingElement.
Weitere Informationen zum Bindungselement, das Nachrichten angibt, werden mithilfe der MTOM-Nachrichtencodierung codiert, finden Sie unter MtomMessageEncodingBindingElement.
Verwenden Sie die MessageEncodingBindingElement Klasse, um einen benutzerdefinierten Nachrichten-Encoder zu implementieren.
Konstruktoren
| Name | Beschreibung |
|---|---|
| BinaryMessageEncodingBindingElement() |
Initialisiert eine neue Instanz der BinaryMessageEncodingBindingElement-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| CompressionFormat |
Ruft ab oder legt das Komprimierungsformat für das Bindungselement fest. |
| MaxReadPoolSize |
Dient zum Abrufen oder Festlegen der maximalen Anzahl von XML-Lesern, die einem Pool zugeordnet sind und bereit für die Verarbeitung eingehender Nachrichten sind. |
| MaxSessionSize |
Ruft die maximale Speichermenge ab, die in einer Sitzung zur Optimierung von Übertragungsprozeduren verfügbar ist, oder legt diese fest. |
| MaxWritePoolSize |
Dient zum Abrufen oder Festlegen der maximalen Anzahl von XML-Autoren, die einem Pool zugeordnet sind und bereit für die Verarbeitung ausgehender Nachrichten sind. |
| MessageVersion |
Dient zum Abrufen oder Festlegen der SOAP-Nachricht und WS-Addressing Versionen, die verwendet oder erwartet werden. |
| ReaderQuotas |
Dient zum Abrufen oder Festlegen von Einschränkungen für die Komplexität von XML-Nachrichten, die von Endpunkten verarbeitet werden können, die mit diesem Bindungselement konfiguriert sind. |
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 BinaryMessageEncodingBindingElement Objekt, das aus dem aktuellen objekt initialisiert wurde. |
| CreateMessageEncoderFactory() |
Erstellt eine Factory für binäre Nachrichten-Encoder, die die SOAP- und WS-Addressing-Versionen und die zeichencodierung verwenden, die durch das aktuelle Codierungsbindungselement angegeben wird. |
| 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) |
| ShouldSerializeMessageVersion() |
Gibt zurück, ob die SOAP-Nachrichtenstrukturversion serialisiert werden soll. |
| ShouldSerializeReaderQuotas() |
Gibt zurück, ob die Werte von Einschränkungen, die auf die Komplexität der SOAP-Nachrichtenstruktur platziert werden, serialisiert werden sollen. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext) |
Schreibt ein benutzerdefiniertes binäres Nachrichtencodierungselement in die generierten Metadaten für einen Endpunkt. |
| IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext) |
Schreibt ein benutzerdefiniertes binäres Nachrichtencodierungselement in die generierte WSDL für einen Vertrag. |
| IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext) |
Schreibt ein benutzerdefiniertes binäres Nachrichtencodierungselement in die generierte WSDL für einen Endpunkt. |