Soap.XSBuiltIns.TXSDateTime
Delphi
TXSDateTime = class(TXSCustomDateTime)
C++
class PASCALIMPLEMENTATION TXSDateTime : public TXSCustomDateTime
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| class | public | Soap.XSBuiltIns.pas Soap.XSBuiltIns.hpp |
Soap.XSBuiltIns | Soap.XSBuiltIns |
Beschreibung
TXSDateTime implementiert einen XML-Schematyp für das Datum und die Uhrzeit, der für aufrufbare Interfaces verwendet werden kann.
Die Klasse TXSDateTime kapselt den einfachen skalaren Typ Datetime, 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 einem aufrufbaren Interface verwendet wird. TXSDateTime unterstützt als Nachkomme von TRemotable dieses Marshaling.
Mit Hilfe der Eigenschaft AsDateTime kann ein TXSDateTime-Wert in einen TDateTime-Wert konvertiert werden. Der resultierende Wert repräsentiert die Uhrzeit im UTC-Format (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 TXSDateTime, die Eingabeparameter für ein aufrufbares Interface 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 TXSDateTime, die durch einen externen Methodenaufruf unter Verwendung eines aufrufbaren Interface 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 eines aufrufbaren Interface (Client) ist für die Erstellung aller als Eingabeparameter übergebenen TXSDateTime-Instanzen verantwortlich. Die Freigabe der vom Client erstellten oder als Ausgabeparameter bzw. Methodenergebnisse zurückgegebenen TXSDateTime-Instanzen muss ebenfalls vom Client selbst vorgenommen werden.