XmlElementAttribute.DataType Property
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Gets or sets the XML Schema definition (XSD) data type of the XML element generated by the XmlSerializer.
Assembly: System.Xml (in System.Xml.dll)
Property Value
Type: System.StringAn XML Schema data type, as defined by the World Wide Web Consortium (www.w3.org) document, XML Schema Part 2: Datatypes.
| Exception | Condition |
|---|---|
| Exception | The XML Schema data type you have specified cannot be mapped to the.NET data type. |
The following table lists the XML Schema simple data types with their.NET equivalents.
XSD data type | .NET data type |
|---|---|
anyURI | |
base64Binary | Array of Byte objects |
boolean | |
byte | |
date | |
dateTime | |
decimal | |
double | |
ENTITY | |
ENTITIES | |
float | |
gDay | |
gMonth | |
gMonthDay | |
gYear | |
gYearMonth | |
hexBinary | Array of Byte objects |
ID | |
IDREF | |
IDREFS | |
int | |
integer | |
language | |
long | |
Name | |
NCName | |
negativeInteger | |
NMTOKEN | |
NMTOKENS | |
normalizedString | |
nonNegativeInteger | |
nonPositiveInteger | |
NOTATION | |
positiveInteger | |
QName | |
duration | |
string | |
short | |
time | |
token | |
unsignedByte | |
unsignedInt | |
unsignedLong | |
unsignedShort |
For the XML Schema base64Binary and hexBinary data types, use an array of Byte structures, and apply a XmlElementAttribute with the DataType set to "base64Binary" or "hexBinary", as appropriate. For the XML Schema time and date data types, use the DateTime type and apply the XmlElementAttribute with the DataType set to "date" or "time".
For every XML Schema type that is mapped to a string, apply the XmlElementAttribute with its DataType property set to the XML Schema type. This can change the serialization format, not only the schema for the member.
Note: |
|---|
The property is case-sensitive, so you must set it exactly to one of the XML Schema data types. |
Note: |
|---|
Passing binary data as an XML element is more efficient than passing it as an XML Schema attribute. |
For more information about
XML data types, see the World Wide Web Consortium (www.w3.org) document, XML Schema Part 2: Datatypes.
Note: