BinaryMessageEncodingBindingElement Class

Definition

Das Bindungselement, das das .NET Binary XML-Format angibt, das verwendet wird, um Nachrichten zu codieren. The binding element that specifies the .NET Binary Format for XML used to encode messages.

public sealed class BinaryMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement, System.ServiceModel.Description.IPolicyExportExtension, System.ServiceModel.Description.IWsdlExportExtension
Vererbung
BinaryMessageEncodingBindingElement
Implementiert

Beispiele

BinaryMessageEncodingBindingElement be = new BinaryMessageEncodingBindingElement();
be.MaxReadPoolSize = 16;
be.MaxSessionSize = 2048;
be.MaxWritePoolSize = 16;
be.MessageVersion = MessageVersion.Default;
XmlDictionaryReaderQuotas quotas = be.ReaderQuotas;

CustomBinding binding = new CustomBinding();
BindingParameterCollection bpCol = new BindingParameterCollection();
BindingContext context = new BindingContext(binding, bpCol);
be.BuildChannelFactory<IDuplexChannel>(context);

CustomBinding binding2 = new CustomBinding();
BindingParameterCollection bpCol2 = new BindingParameterCollection();
BindingContext 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

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).

BinaryMessageEncodingBindingElement ist das Bindungselement, das das .NET Binary XML-Format angibt, das verwendet werden soll, um Nachrichten zu codieren. Es bietet Optionen zum Festlegen der Zeichencodierung und der SOAP- und WS-Adressierungsversion.The BinaryMessageEncodingBindingElement is the binding element that specified the .NET Binary Format for XML should be used for encoding messages, and has options to specify the character encoding and the SOAP and WS-Addressing version to be used. Binäre Codierung ist bezüglich der Codierungsoptionen am effizientesten, aber am wenigsten interoperabel.Binary encoding is most efficient but least interoperable of the encoding options.

Weitere Informationen zu der Bindungselements, der angibt, werden Nachrichten codiert, mit einer Textdarstellung des XML-Codes, finden Sie unter TextMessageEncodingBindingElement.For more information about the binding element that specifies messages are encoded using a textual representation of XML, see TextMessageEncodingBindingElement.

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.

Verwenden Sie die MessageEncodingBindingElement-Klasse, um einen benutzerdefinierten Nachrichtenencoder zu implementieren.To implement a custom message encoder, use the MessageEncodingBindingElement class.

Konstruktoren

BinaryMessageEncodingBindingElement()

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

Eigenschaften

CompressionFormat

Ruft das Komprimierungsformat für das Bindungselement ab oder legt dieses fest. Gets or sets the compression format for the binding element.

MaxReadPoolSize

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

MaxSessionSize

Ruft die Höchstmenge an Arbeitsspeicher innerhalb einer Sitzung ab oder legt sie fest, die verfügbar ist, um Übertragungsprozeduren zu optimieren. Gets or sets the maximum amount of memory available within a session for optimizing transmission procedures.

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. Gets or sets the maximum number of XML writers that are allocated to a pool and are ready for use to process outgoing messages.

MessageVersion

Ruft die Versionen der SOAP-Nachricht und WS-Addressing ab, die verwendet oder erwartet werden, bzw. legt diese fest. Gets or sets the SOAP message and WS-Addressing versions that are used or expected.

ReaderQuotas

Ruft Beschränkungen der Komplexität von XML-Meldungen ab oder legt Beschränkungen fest, die von Endpunkten verarbeitet werden können, die mit diesem Bindungselement konfiguriert werden. Gets constraints on the complexity of XML messages that can be processed by endpoints configured with this binding element.

Methoden

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)

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)

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)

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

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

CreateMessageEncoderFactory()

Erstellt eine Factory für binäre Nachrichtenencoder, die die SOAP- und WS-Adressierungsversionen und die Zeichencodierung verwenden, die vom aktuellen Codierungsbindungselement festgelegt wurden. Creates a factory for binary message encoders that employ the SOAP and WS-Addressing versions and the character encoding specified by the current encoding binding element.

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

Fungiert als die Standardhashfunktion. Serves as the default hash function.

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

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

GetType()

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

(Inherited from Object)
MemberwiseClone()

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

(Inherited from Object)
ShouldSerializeMessageVersion()

Gibt zurück, ob die SOAP-Meldungsstrukturversion serialisiert werden soll. Returns whether the SOAP message structure version should be serialized.

ShouldSerializeReaderQuotas()

Gibt zurück, ob die Werte von Einschränkungen, die auf der Komplexität der SOAP-Meldungsstruktur platziert wurden, serialisiert werden sollen. Returns whether the values of constraints placed on the complexity of SOAP message structure should be serialized.

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)

Schreibt benutzerdefinierte binäre Nachrichtencodierungselemente in die generierten Metadaten für einen Endpunkt. Writes a custom binary message encoding elements into the generated metadata for an endpoint.

IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext)

Schreibt benutzerdefinierte binäre Nachrichtencodierungselemente in die generierte WSDL für einen Vertrag. Writes a custom binary message encoding elements into the generated WSDL for a contract.

IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext)

Schreibt benutzerdefinierte binäre Nachrichtencodierungselemente in die generierte WSDL für einen Endpunkt. Writes a custom binary message encoding elements into the generated WSDL for an endpoint.

Gilt für: