Von mit ASP.NET erstellten XML-Webdiensten unterstützte Datentypen
Dieses Thema bezieht sich auf eine veraltete Technologie. XML-Webdienste und XML-Webdienstclients sollten nun mithilfe der folgenden Technologie erstellt werden: Windows Communication Foundation.
Alle Programmiersprachen definieren verschiedene Datentypen, in denen unterschiedliche Arten von Daten gespeichert werden können. Die einfachen oder primitiven Datentypen ähneln sich in den verschiedenen Programmiersprachen weitgehend. Es gibt jedoch feine Unterschiede, die die direkte Zuordnung zwischen Sprachen verhindern. Wegen dieser Unterschiede ist es schwierig, einen Webdienst zu erstellen, auf den beliebige Clientanwendungen zugreifen können.
Um die größtmögliche Zugriffssicherheit zu erzielen, unterstützen Webdienste eine Sammlung von primitiven Datentypen, die mit XML codiert und serialisiert werden können.
Die folgende Tabelle zeigt die von Webdiensten unterstützten primitiven Datentypen. Dabei handelt es sich um die im zweiten Teil der XSD-Sprache (XML Schema Definition) enthaltenen Datentypen mit ihren äquivalenten Datentypen in C++ und der Common Language Runtime.
| XML Schema Definitionssprache (XSD) | C++ | Common Language Runtime |
|---|---|---|
base64Binary |
Byte[] |
|
boolean |
bool |
Boolean |
byte |
char, __int8 |
SByte |
double |
double |
Double |
dateTime |
DateTime |
|
decimal |
|
Decimal |
float |
float |
Single |
int |
int, long, __int32 |
Int32 |
long |
__int64 |
Int64 |
QName |
|
XmlQualifiedName |
short |
short, __int16 |
Int16 |
string |
BSTR |
String |
time |
|
DateTime |
unsignedByte |
unsigned __int8 |
Byte |
unsignedInt |
unsigned __int32 |
UInt32 |
unsignedLong |
unsigned __int64 |
UInt64 |
unsignedShort |
unsigned __int16 |
UInt16 |
Arrays von Primitiven und Enumerationen |
Arrays der oben genannten Typen |
Weitere Informationen zur Konvertierung von Datentypen der Common Language Runtime in Datentypen anderer Sprachen, z. B. C# und Visual Basic .NET, finden Sie unter .NET Framework-Klassenbibliothek.
Welche Datentypen verfügbar sind, hängt von dem vom Webdienst verwendeten Protokoll ab. Zum Beispiel sind die Protokolle HTTP-GET und HTTP-POST beide auf Name/Wert-Paare beschränkt. SOAP ermöglicht dagegen eine vielfältigere Verwendung von XML für die Codierung und Serialisierung komplexer Datenstrukturen, z. B. Klassen.
In der folgenden Tabelle sind die für HTTP-GET und HTTP-POST unterstützten Datentypen aufgeführt.
| Type | Beschreibung |
|---|---|
Primitive Typen (begrenzt) |
Die folgenden primitiven Typen werden in als Zeichenfolgen dargestellte Paare aus Name und Wert konvertiert: Boolean, Currency, DateTime, Decimal, Double, Int16, Int32, Int64, Single, String, UInt16, Uint32 und UInt64. |
Enumerationstypen |
Aus der Sicht des Clients werden Enumerationstypen zu Klassen mit einem statischen konstanten Zeichenfolgenfeld für jeden Wert. |
Arrays von Primitiven und Enumerationen |
Arrays der oben genannten Typen |
Die von Webdiensten unterstützten Datentypen stehen bei Verwendung des SOAP-Protokolls in direkter Wechselbeziehung mit den Datentypen, die in XML serialisiert werden können. ASP.NET serialisiert und deserialisiert XML-Code mithilfe der XmlSerializer-Klasse. Nähere Informationen zu den Typen, die von XmlSerializer unterstützt werden, finden Sie unter Einführung in die XML-Serialisierung.
Zusätzlich zu den in der vorangehenden Tabelle aufgelisteten Typen unterstützen Webdienste, die das SOAP-Protokoll verwenden, die folgenden zusätzlichen Datentypen.
| Type | Beschreibung |
|---|---|
Klassen und Strukturen, Arrays von Klassen und Strukturen |
Klasse und Strukturtypen mit öffentlichen Feldern oder Eigenschaften. Die öffentlichen Eigenschaften und Felder werden deserialisiert. Klassen müssen über einen Standardkonstruktor verfügen, der keine Parameter akzeptiert. |
DataSet, Arrays von DataSet |
ADO.NET-DataSet-Typen. Dataset-Typen können auch als Felder in Klassen oder Strukturen angezeigt werden. |
XmlNode, Arrays von XmlNode |
XmlNode ist eine speicherinterne Darstellung eines XML-Fragments. XmlNodes-Typen können als Parameter oder Rückgabewerte übergeben werden und werden dem Rest des XML-Codes hinzugefügt, der SOAP-kompatibel an den Webdienst übergeben wird. Daher können Sie XML-Code übergeben oder zurückgeben, auch wenn die Struktur zwischen den Aufrufen geändert wird oder Sie nicht alle übergebenen Typen kennen. XmlNode-Typen können auch als Felder in Klassen oder Strukturen angezeigt werden. |
Siehe auch
Konzepte
Erstellen von XML-Webdienstclients
Weitere Ressourcen
Introducing XML Serialization
.NET Framework Class Library
XML-Webdienste, die ASP.NET verwenden