BinaryMessageEncodingBindingElement Osztály

Definíció

Névtér:

System.ServiceModel.Channels

Szerelvények:

System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Csomag:

System.ServiceModel.Primitives v10.0.652802

Forrás:

BinaryMessageEncodingBindingElement.cs

Az üzenetek kódolásához használt XML .NET bináris formátumát meghatározó kötési elem.

public ref class BinaryMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement

public sealed class BinaryMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement

type BinaryMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement

Public NotInheritable Class BinaryMessageEncodingBindingElement
Inherits MessageEncodingBindingElement

Öröklődés

Object

BindingElement

MessageEncodingBindingElement

BinaryMessageEncodingBindingElement

Példák

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)

Megjegyzések

A kódolás az üzenet bájtok sorozatává alakításának folyamata. A dekódolás a fordított folyamat. A Windows kommunikációs alaprendszer (WCF) a SOAP-üzenetek kódolásának három típusát tartalmazza: Szöveg, Bináris és Üzenetátvitel optimalizálási mechanizmusa (MTOM).

BinaryMessageEncodingBindingElement az a kötési elem, amely meghatározza, hogy az XML .NET bináris formátumát kell használni az üzenetek kódolásához. Megadhatja a karakterkódolást, valamint a HASZNÁLNI kívánt SOAP és WS-Addressing verziót. A bináris kódolás a kódolási lehetőségek leghatékonyabb, de legkevésbé együttműködő módja.

Az üzeneteket meghatározó kötési elemről további információt az XML szöveges ábrázolása alapján kódolunk, lásd: TextMessageEncodingBindingElement.

Az üzeneteket meghatározó kötési elemről további információt az MTOM-üzenetkódolás használatával kódolunk, lásd: MtomMessageEncodingBindingElement.

Egyéni üzenetkódoló implementálásához használja az osztályt MessageEncodingBindingElement .

Konstruktorok

Name	Description
BinaryMessageEncodingBindingElement()	Inicializálja a BinaryMessageEncodingBindingElement osztály új példányát.

Tulajdonságok

Name	Description
CompressionFormat	Lekéri vagy beállítja a kötéselem tömörítési formátumát.
MaxReadPoolSize	Lekéri vagy beállítja a készlethez lefoglalt XML-olvasók maximális számát, és készen áll a bejövő üzenetek feldolgozására.
MaxSessionSize	Lekéri vagy beállítja a munkameneten belül elérhető maximális memóriamennyiséget az átviteli eljárások optimalizálásához.
MaxWritePoolSize	Lekéri vagy beállítja a készlethez lefoglalt XML-írók maximális számát, és készen áll a kimenő üzenetek feldolgozására.
MessageVersion	Lekéri vagy beállítja a SOAP-üzenetet és WS-Addressing használt vagy várt verziókat.
ReaderQuotas	Lekéri vagy beállítja a kötéselemhez konfigurált végpontok által feldolgozható XML-üzenetek összetettségére vonatkozó korlátozásokat.

Metódusok

Name	Description
BuildChannelFactory<TChannel>(BindingContext)	A channel factory vermet azon az ügyfélen hozza létre, amely egy adott típusú csatornát hoz létre egy adott környezethez.
CanBuildChannelFactory<TChannel>(BindingContext)	Egy értéket ad vissza, amely jelzi, hogy a kötési elem képes-e csatorna-előállítót létrehozni egy adott csatornatípushoz. (Öröklődés forrása BindingElement)
Clone()	Létrehoz egy új BinaryMessageEncodingBindingElement objektumot az aktuálisból inicializálva.
CreateMessageEncoderFactory()	Létrehoz egy gyárat bináris üzenetkódolók számára, amelyek a SOAP és WS-Addressing verziókat, valamint az aktuális kódolási kötéselem által megadott karakterkódolást alkalmazzák.
GetProperty<T>(BindingContext)	A kötéselem-verem megfelelő rétegéből kért, adott esetben beírt objektumot ad vissza.