TextMessageEncodingBindingElement Klasa

Definicja

Element powiązania, który określa kodowanie znaków i przechowywanie wersji komunikatów używanych do tekstowych komunikatów SOAP.The binding element that specifies the character encoding and message versioning used for text-based SOAP messages.

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
Dziedziczenie
TextMessageEncodingBindingElement
Implementuje

Uwagi

Kodowanie jest procesem przekształcania komunikatu w sekwencję bajtów.Encoding is the process of transforming a message into a sequence of bytes. Dekodowanie jest procesem wycofywania.Decoding is the reverse process. Windows Communication Foundation (WCF) zawiera trzy typy kodowania komunikatów protokołu SOAP: tekst, binarny i mechanizm optymalizacji transmisji wiadomości (MTOM).Windows Communication Foundation (WCF) includes three types of encoding for SOAP messages: Text, Binary and Message Transmission Optimization Mechanism (MTOM).

Kodowanie tekstu reprezentowane przez TextMessageEncodingBindingElement to najbardziej interoperacyjny, ale najmniej wydajny koder dla wiadomości XML.The text encoding represented by the TextMessageEncodingBindingElement is the most interoperable, but the least efficient encoder for XML messages. Usługa sieci Web lub klient usługi sieci Web może ogólnie zrozumieć tekst XML.Web service or Web service client can generally understand textual XML. Jednak przesyłanie dużych bloków danych binarnych jako tekstu nie jest wydajne.However, transmitting large blocks of binary data as text is not efficient.

Aby uzyskać więcej informacji na temat powiązania elementu, który określa komunikaty, przy użyciu formatu binarnego platformy .NET dla języka XML, zobacz BinaryMessageEncodingBindingElement .For more information about the binding element that specifies messages are encoded using the .NET Binary Format for XML, see BinaryMessageEncodingBindingElement.

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 .For more information about the binding element that specifies messages are encoded using the MTOM message encoding, see MtomMessageEncodingBindingElement.

Aby uzyskać więcej informacji na temat implementowania niestandardowego kodera komunikatów, użyj MessageEncodingBindingElement klasy.For more information about how to implement a custom message encoder, use the MessageEncodingBindingElement class.

Konstruktory

TextMessageEncodingBindingElement()

Inicjuje nowe wystąpienie klasy TextMessageEncodingBindingElement.Initializes a new instance of the TextMessageEncodingBindingElement class.

TextMessageEncodingBindingElement(MessageVersion, Encoding)

Inicjuje nowe wystąpienie TextMessageEncodingBindingElement klasy z określoną wersją i kodowaniem wiadomości.Initializes a new instance of the TextMessageEncodingBindingElement class with a specified message version and encoding.

Właściwości

MaxReadPoolSize

Pobiera lub ustawia liczbę czytników, które są przydzielane do puli i są gotowe do użycia w celu przetwarzania komunikatów przychodzących.Gets or sets the number of readers that are allocated to a pool and ready for use to process incoming messages.

MaxWritePoolSize

Pobiera lub ustawia liczbę modułów zapisujących, które są przydzielane do puli i są gotowe do użycia w celu przetwarzania komunikatów wychodzących.Gets or sets the number of writers that are allocated to a pool and ready for use to process outgoing messages.

MessageVersion

Pobiera lub ustawia wersje protokołu SOAP i WS-Addressing, które są używane do formatowania wiadomości tekstowej.Gets or sets the SOAP and WS-Addressing versions that are used to format the text message.

ReaderQuotas

Pobiera lub ustawia ograniczenia złożoności komunikatów protokołu SOAP, które mogą być przetwarzane przez punkty końcowe skonfigurowane za pomocą tego powiązania.Gets or sets constraints on the complexity of SOAP messages that can be processed by endpoints configured with this binding.

WriteEncoding

Pobiera lub ustawia kodowanie używane do formatowania znaków w wiadomości tekstowej.Gets or sets the encoding that is used to format the characters in the text message.

Metody

BuildChannelFactory<TChannel>(BindingContext)

Kompiluje stos fabryki kanałów na kliencie, który tworzy określony typ kanału dla określonego kontekstu.Builds the channel factory stack on the client that creates a specified type of channel for a specified context.

BuildChannelListener<TChannel>(BindingContext)

Kompiluje odbiornik kanału w usłudze, który akceptuje określony typ kanału dla określonego kontekstu.Builds the channel listener on the service that accepts a specified type of channel for a specified context.

BuildChannelListener<TChannel>(BindingContext)

Inicjuje odbiornik kanału w celu akceptowania kanałów określonego typu z kontekstu powiązania.Initializes a channel listener to accept channels of a specified type from the binding context.

(Odziedziczone po BindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)

Zwraca wartość wskazującą, czy element Binding może kompilować fabrykę kanałów dla określonego typu kanału.Returns a value that indicates whether the binding element can build a channel factory for a specific type of channel.

(Odziedziczone po BindingElement)
CanBuildChannelListener<TChannel>(BindingContext)

Zwraca wartość wskazującą, czy bieżące powiązanie może kompilować odbiornik dla określonego typu kanału i kontekstu.Returns a value that indicates whether the current binding can build a listener for a specified type of channel and context.

CanBuildChannelListener<TChannel>(BindingContext)

Zwraca wartość wskazującą, czy element powiązania może kompilować odbiornik dla określonego typu kanału.Returns a value that indicates whether the binding element can build a listener for a specific type of channel.

(Odziedziczone po BindingElement)
Clone()

Tworzy nowy TextMessageEncodingBindingElement obiekt zainicjowany z poziomu bieżącego.Creates a new TextMessageEncodingBindingElement object initialized from the current one.

CreateMessageEncoderFactory()

Tworzy fabrykę dla koderów wiadomości tekstowych, które wykorzystują wersję wiadomości i kodowanie znaków określone przez bieżący element powiązania kodowania.Creates a factory for text message encoders that employs the message version and character encoding specified by the current encoding binding element.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetProperty<T>(BindingContext)

Zwraca żądany obiekt typu, jeśli jest obecny, z odpowiedniej warstwy w stosie elementów powiązania.Returns a typed object requested, if present, from the appropriate layer in the binding element stack.

GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ShouldSerializeReaderQuotas()

Zwraca czy ograniczenia dotyczące złożoności struktury komunikatów SOAP powinny być serializowane.Returns whether the constraints placed on the complexity of SOAP message structure should be serialized.

ShouldSerializeWriteEncoding()

Zwraca czy wartość Encoding użyta do sformatowania znaków komunikatu powinna być serializowana.Returns whether the Encoding that is used to format the message characters should be serialized.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Jawne implementacje interfejsu

IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext)

Generuje informacje o kontrakcie WSDL z zasad kodowania zawartych w elemencie Binding.Generates WSDL contract information from encoding policies contained in the binding element.

IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext)

Generuje informacje o kontrakcie WSDL z zasad kodowania zawartych w elemencie Binding.Generates WSDL contract information from encoding policies contained in the binding element.

IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext)

Generuje informacje o kontrakcie WSDL z zasad kodowania zawartych w elemencie Binding.Generates WSDL contract information from encoding policies contained in the binding element.

Dotyczy