Soap.XSBuiltIns.TXSHexBinary
Delphi
TXSHexBinary = class(TRemotableXS)
C++
class PASCALIMPLEMENTATION TXSHexBinary : public Soap::Invokeregistry::TRemotableXS
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| class | public | Soap.XSBuiltIns.pas Soap.XSBuiltIns.hpp |
Soap.XSBuiltIns | Soap.XSBuiltIns |
Beschreibung
TXSHexBinary implementiert das XML-Schema mit einem hexBinary-Typ, um die Verwendung mit aufrufbaren Schnittstellen zu ermöglichen.
TXSHexBinary kapselt den von W3C definierten, einfachen skalaren hexBinary-Typ für XML-Schemas. Da es in Delphi bzw. C++ für diesen Typ keine direkte Entsprechung gibt, ist ein spezielles Marshaling erforderlich, wenn der Typ in einer aufrufbaren Schnittstelle verwendet wird. TXSHexBinary ermöglicht dieses Marshaling, da die Klasse ein Nachkomme von TRemotable ist.
Verwenden Sie die Eigenschaft AsByteArray, um den Wert eines TXSHexBinary-Objekts als Byte-Array abzurufen oder festzulegen. Sie können den Wert eines TXSHexBinary-Objekts auch aus einem Integer generieren, indem Sie diesen mit der globalen Funktion IntToHex in einen hexadezimalen String konvertieren und ihn anschließend der Eigenschaft HexBinaryString zuweisen.
In Serveranwendungen werden Instanzen von TXSHexBinary als Eingabeparameter für eine aufrufbare Schnittstelle automatisch erstellt, wenn der Methodenaufruf interpretiert wird. Die Instanzen werden automatisch freigegeben, nachdem Ausgabeparameter oder Rückgabewerte generiert wurden, die an den Client gesendet werden sollen. Wird eine TXSHexBinary-Instanz in einer remote über eine aufrufbare Schnittstelle aufgerufenen Methode erstellt, wird diese Instanz automatisch freigegeben, nachdem der Wert des TRemotable-Nachkommen für den Rücktransport zur Client-Anwendung generiert wurde.
Der Aufrufer einer aufrufbaren Schnittstelle (Client) ist für die Erstellung aller als Eingabeparameter übergebenen TXSHexBinary-Instanzen verantwortlich. Die Freigabe der vom Client erstellten oder als Ausgabeparameter bzw. Methodenergebnisse zurückgegebenen TXSHexBinary-Instanzen muss ebenfalls vom Client selbst vorgenommen werden.