BinaryMessageEncodingBindingElement Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.ServiceModel.Channels

Zestaw:: System.ServiceModel.Primitives.dll

Zestaw:: System.ServiceModel.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Element powiązania określający format binarny platformy .NET dla formatu XML używany do kodowania komunikatów.

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

Dziedziczenie: Object

BindingElement

MessageEncodingBindingElement
BinaryMessageEncodingBindingElement

Implementuje: IPolicyExportExtension IWsdlExportExtension

Przykłady

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)

Uwagi

Kodowanie to proces przekształcania komunikatu w sekwencję bajtów. Dekodowanie jest procesem odwrotnym. program Windows Communication Foundation (WCF) zawiera trzy typy kodowania komunikatów PROTOKOŁU SOAP: mechanizm optymalizacji tekstu, binarnej i transmisji komunikatów (MTOM).

BinaryMessageEncodingBindingElement to element powiązania, który określa, że format binarny platformy .NET dla formatu XML powinien być używany do kodowania komunikatów. Dostępne są opcje określania kodowania znaków oraz wersji protokołu SOAP i WS-Addressing do użycia. Kodowanie binarne jest najbardziej wydajne, ale najmniej współdziała z opcjami kodowania.

Aby uzyskać więcej informacji na temat elementu powiązania, który określa komunikaty są kodowane przy użyciu tekstowej reprezentacji XML, zobacz TextMessageEncodingBindingElement.

Aby uzyskać więcej informacji na temat elementu powiązania, który określa komunikaty są kodowane przy użyciu kodowania komunikatów MTOM, zobacz MtomMessageEncodingBindingElement.

Aby zaimplementować niestandardowy koder komunikatów, użyj MessageEncodingBindingElement klasy .

Konstruktory

BinaryMessageEncodingBindingElement()

Inicjuje nowe wystąpienie klasy BinaryMessageEncodingBindingElement.

Właściwości

CompressionFormat	Pobiera lub ustawia format kompresji elementu powiązania.
MaxReadPoolSize	Pobiera lub ustawia maksymalną liczbę czytników XML przydzielonych do puli i są gotowe do użycia do przetwarzania komunikatów przychodzących.
MaxSessionSize	Pobiera lub ustawia maksymalną ilość pamięci dostępnej w ramach sesji na potrzeby optymalizacji procedur transmisji.
MaxWritePoolSize	Pobiera lub ustawia maksymalną liczbę składników zapisywania XML przydzielonych do puli i są gotowe do przetwarzania komunikatów wychodzących.
MessageVersion	Pobiera lub ustawia komunikat PROTOKOŁU SOAP i WS-Addressing wersje, które są używane lub oczekiwane.
ReaderQuotas	Pobiera lub ustawia ograniczenia złożoności komunikatów XML, które mogą być przetwarzane przez punkty końcowe skonfigurowane za pomocą tego elementu powiązania.

Metody

BuildChannelFactory<TChannel>(BindingContext)	Tworzy stos fabryki kanału na kliencie, który tworzy określony typ kanału dla określonego kontekstu.
BuildChannelListener<TChannel>(BindingContext)	Tworzy odbiornik kanału w usłudze, który akceptuje określony typ kanału dla określonego kontekstu.
BuildChannelListener<TChannel>(BindingContext)	Inicjuje odbiornik kanału, aby akceptował kanały określonego typu z kontekstu powiązania. (Odziedziczone po BindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)	Zwraca wartość wskazującą, czy element powiązania może utworzyć fabrykę kanałów dla określonego typu kanału. (Odziedziczone po BindingElement)
CanBuildChannelListener<TChannel>(BindingContext)	Zwraca wartość wskazującą, czy bieżące powiązanie może utworzyć odbiornik dla określonego typu kanału i kontekstu.
CanBuildChannelListener<TChannel>(BindingContext)	Zwraca wartość wskazującą, czy element powiązania może skompilować odbiornik dla określonego typu kanału. (Odziedziczone po BindingElement)
Clone()	Tworzy nowy BinaryMessageEncodingBindingElement obiekt zainicjowany na podstawie bieżącego.
CreateMessageEncoderFactory()	Tworzy fabrykę koderów komunikatów binarnych, które korzystają z wersji SOAP i WS-Addressing oraz kodowania znaków określonego przez bieżący element powiązania kodowania.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetProperty<T>(BindingContext)	Zwraca żądany obiekt wpisany, jeśli istnieje, z odpowiedniej warstwy w stosie elementu powiązania.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ShouldSerializeMessageVersion()	Zwraca, czy wersja struktury komunikatów protokołu SOAP powinna być serializowana.
ShouldSerializeReaderQuotas()	Zwraca, czy wartości ograniczeń nakładanych na złożoność struktury komunikatów protokołu SOAP powinny być serializowane.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext)	Zapisuje niestandardowe elementy kodowania komunikatów binarnych w wygenerowanych metadanych dla punktu końcowego.
IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext)	Zapisuje niestandardowe elementy kodowania komunikatów binarnych w wygenerowanym języku WSDL dla kontraktu.
IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext)	Zapisuje niestandardowe elementy kodowania komunikatów binarnych w wygenerowanym języku WSDL dla punktu końcowego.

Dotyczy