Soap.XSBuiltIns.TXSString
Delphi
TXSString = class(TRemotableXS)
C++
class PASCALIMPLEMENTATION TXSString : public Soap::Invokeregistry::TRemotableXS
Properties
Type | Visibility | Source | Unit | Parent |
---|---|---|---|---|
class | public | Soap.XSBuiltIns.pas Soap.XSBuiltIns.hpp |
Soap.XSBuiltIns | Soap.XSBuiltIns |
Description
TXSString implements the XML schema string type so that it can be used on invokable interfaces.
TXSString acts as a wrapper for the string type that W3C defines for XML schemas. Because this type does not correspond directly to a Delphi or C++ type, it requires special marshaling when used in an invokable interface. TXSString enables this marshaling because it is a descendant of TRemotable.
To convert a TXSString value to a String value, use the XSToNative method.
On server applications, instances of TXSString that are input parameters on an invokable interface are automatically created when the method call is unmarshaled and automatically freed after any output parameters or return values are marshaled so that they can be sent to the client. When a TXSString instance is created in a method that was called remotely using an invokable interface, the instance is automatically freed after the value of the TRemotable descendant is marshaled for transport back to the client application.
The caller of an invokable interface (client) is responsible for creating any TXSString instances that it passes as input parameters, and for freeing any TXSString instances it creates or that are returned as output parameters or method results.