Soap.OPToSOAPDomConv.TOPToSoapDomConvert.Encoding

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

property Encoding: DOMString read GetEncoding write SetEncoding;

C++

__property System::UnicodeString Encoding = {read=GetEncoding, write=SetEncoding};

Properties

Type Visibility Source Unit Parent
property published
Soap.OPToSOAPDomConv.pas
Soap.OPToSOAPDomConv.hpp
Soap.OPToSOAPDomConv TOPToSoapDomConvert

Description

Indicates the character set to use for encoded method calls.

Use Encoding to indicate the character set that is used for encoded method calls. Encoding causes the converter to make character set conversions using the DOM, rather than at the transport level. This approach is more efficient than transport-level encoding. If you set Encoding, the Options property should not include soUTF8EncodeXML and soUTF8InHeader.

If you do not specify an encoding (that is, if Encoding is an empty string), TOPToSoapDomConvert converts characters at the transport level assuming UTF-8.

TOPToSoapDomConvert uses the DOM parser identified by the global DefaultDOMVendor variable to perform its conversions. Encoding must indicate an encoding that this default DOM parser supports.

Note: Some Web Services (such as Apache or .NET) require transport level encoding rather than DOM level encoding. In such cases, it is possible that setting Encoding can cause problems because the Web Service converts characters at the transport level and then converts a second time because of the encoding attribute that Encoding adds to the XML representation. If a Web Service requires transport-level encoding and assumes UTF8, Encoding should be an empty string and the Options property should include soUTF8EncodeXML and soUTF8InHeader.

See Also