From RAD Studio API Documentation
Jump to: navigation, search



TXSString = class(TRemotableXS)


class PASCALIMPLEMENTATION TXSString : public Soap::Invokeregistry::TRemotableXS


Type Visibility Source Unit Parent
class public
Soap.XSBuiltIns Soap.XSBuiltIns


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.

See Also