Soap.XSBuiltIns.TXSTime
Delphi
TXSTime = class(TRemotableXS)
C++
class PASCALIMPLEMENTATION TXSTime : public Soap::Invokeregistry::TRemotableXS
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| class | public | Soap.XSBuiltIns.pas Soap.XSBuiltIns.hpp |
Soap.XSBuiltIns | Soap.XSBuiltIns |
Beschreibung
TXSTime implementiert einen XML-Schematyp für die Uhrzeit, der für aufrufbare Schnittstellen verwendet werden kann.
Die Klasse TXSTime kapselt den einfachen skalaren Typ Time, der von W3C für XML-Schemas definiert wird. 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. TXSTime ermöglicht dieses Marshaling, da die Klasse ein Nachkomme von TRemotable ist.
Mit Hilfe der Eigenschaft AsTime kann ein TXSTime-Wert in einen TDateTime-Wert konvertiert werden. Mit den Eigenschaften Hour, Minute, Second und Millisecond können Sie die Stunde, die Minute, die Sekunde und die Millisekunde festlegen. Diese Eigenschaften stellen die Uhrzeit im UTC-Format dar (Universal Time Coordinated). Um die lokale Uhrzeit zu erhalten, müssen Sie die Stunde und die Minute mit Hilfe der Eigenschaften HourOffset und MinuteOffset korrigieren.
In Serveranwendungen werden Instanzen von TXSTime, die Eingabeparameter für eine aufrufbare Schnittstelle darstellen, beim Unmarshaling des Methodenaufrufs automatisch erstellt. Ihre Freigabe erfolgt ebenfalls automatisch, sobald das Marshaling der Ausgabeparameter oder des Rückgabewertes abgeschlossen ist und die Werte zur Übertragung an den Client bereitstehen. Instanzen von TXSTime, die durch einen externen Methodenaufruf unter Verwendung einer aufrufbaren Schnittstelle erstellt wurden, werden automatisch freigegeben, sobald das Marshaling des Wertes des TRemotable-Nachkommen für die Rückübertragung an die Client-Anwendung abgeschlossen ist.
Der Aufrufer einer aufrufbaren Schnittstelle (Client) ist für die Erstellung aller als Eingabeparameter übergebenen TXSTime-Instanzen verantwortlich. Die Freigabe der vom Client erstellten oder als Ausgabeparameter bzw. Methodenergebnisse zurückgegebenen TXSTime-Instanzen muss ebenfalls vom Client selbst vorgenommen werden.