RAD Studio VCL Reference
ContentsIndex
PreviousUpNext
TXSHexBinary Class

TXSHexBinary implements the XML schema hexBinary type so that it can be used on invokable interfaces.

Pascal
TXSHexBinary = class(TRemotableXS);
C++
class TXSHexBinary : public TRemotableXS;

TXSHexBinary acts as a wrapper for the simple scalar hexBinary 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. TXSHexBinary enables this marshaling because it is a descendant of TRemotable

Use the AsByteArray property to get or set the value of TXSHexBinary as an array of bytes. You can also set the value of TXSHexBinary from an integer using the global IntToHex function to convert an integer into a hexadecimal string and setting the HexBinaryString property. 

On server applications, instances of TXSHexBinary 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 value are marshaled so that they can be sent to the client. When a TXSHexBinary 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 TXSHexBinary instances that it passes as input parameters, and for freeing any TXSHexBinary instances it creates or that are returned as output parameters or method results. 

 

Copyright(C) 2009 Embarcadero Technologies, Inc. All Rights Reserved.
What do you think about this topic? Send feedback!