TOPToSoapDomConvert.Encoding Property

Indicates the character set to use for encoded method calls.

Pascal

property Encoding: WideString;

C++

__property BSTR Encoding;

Description

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.