Soap.XSBuiltIns.TXSDate
Delphi
TXSDate = class(TRemotableXS)
C++
class PASCALIMPLEMENTATION TXSDate : public Soap::Invokeregistry::TRemotableXS
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| class | public | Soap.XSBuiltIns.pas Soap.XSBuiltIns.hpp |
Soap.XSBuiltIns | Soap.XSBuiltIns |
Beschreibung
TXSDate implementiert einen XML-Schematyp für das Datum, der für aufrufbare Schnittstellen verwendet werden kann.
Die Klasse TXSDate kapselt den einfachen skalaren Typ Date, 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. TXSDate unterstützt als Nachkomme von TRemotable dieses Marshaling.
Mit Hilfe der Eigenschaft AsDate kann ein TXSDate-Wert in einen TDateTime-Wert konvertiert werden. Mit den Eigenschaften Year, Month und Day können Sie das Jahr, den Monat und den Tag festlegen.
In Serveranwendungen werden Instanzen von TXSDate, 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 TXSDate, 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 TXSDate-Instanzen verantwortlich. Die Freigabe der vom Client erstellten oder als Ausgabeparameter bzw. Methodenergebnisse zurückgegebenen TXSDate-Instanzen muss ebenfalls vom Client selbst vorgenommen werden.