XmlTextAttribute::DataType Property
Gets or sets the XML Schema definition language (XSD) data type of the text generated by the XmlSerializer.
Assembly: System.Xml (in System.Xml.dll)
Property Value
Type: System::String^An XML Schema (XSD) 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. |
| InvalidOperationException | The XML Schema data type you have specified is invalid for the property and cannot be converted to the member type. |
Setting the DataType property to an XML Schema simple data type affects the format of the generated XML. For example, setting the property to "date" causes the generated text to be formatted in the general date style, for example: 2001-08-31. By contrast, setting the property to "dateTime" results in a specific instant as defined by the International Organization for Standardization document 8601, "Representations of Dates and Times", for example: 2001-08-15T06:59:11.0508456-07:00.
The effect of setting the DataType property can also be seen when using the XML Schema Definition Tool (Xsd.exe) to generate the XML Schema for a compiled file. For more information on using the tool, see The XML Schema Definition Tool and XML Serialization.
The following table lists the XML Schema simple data types with their .NET equivalents.
For the XML Schema base64Binary and hexBinary data types, use an array of Byte structures, and apply a XmlTextAttribute 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 XmlTextAttribute with the DataType set to "date" or "time".
For every XML Schema data type that is mapped to a string, apply the XmlTextAttribute with its DataType property set to the XML Schema data type. Note that this does not change the serialization format, 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 attribute. |
For more information about XML Schema data types, see the World Wide Web Consortium (www.w3.org) document named "XML Schema Part 2: Datatypes".
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 |
#using <System.Xml.dll> #using <System.dll> using namespace System; using namespace System::Xml::Serialization; using namespace System::IO; public ref class Group1 { public: // The XmlTextAttribute with type set to string informs the // XmlSerializer that strings should be serialized as XML text. [XmlText(String::typeid)] [XmlElement(Int32::typeid)] [XmlElement(Double::typeid)] array<Object^>^All; Group1() { array<Object^>^temp = {321,"One",2,3.0,"Two"}; All = temp; } }; public enum class GroupType { Small, Medium, Large }; public ref class Group2 { public: [XmlText(Type=GroupType::typeid)] GroupType Type; }; public ref class Group3 { public: [XmlText(Type=DateTime::typeid)] DateTime CreationTime; Group3() { CreationTime = DateTime::Now; } }; public ref class Test { public: static void main() { Test^ t = gcnew Test; t->SerializeArray( "XmlText1.xml" ); t->SerializeEnum( "XmlText2.xml" ); t->SerializeDateTime( "XmlText3.xml" ); } private: void SerializeArray( String^ filename ) { XmlSerializer^ ser = gcnew XmlSerializer( Group1::typeid ); Group1^ myGroup1 = gcnew Group1; TextWriter^ writer = gcnew StreamWriter( filename ); ser->Serialize( writer, myGroup1 ); writer->Close(); } void SerializeEnum( String^ filename ) { XmlSerializer^ ser = gcnew XmlSerializer( Group2::typeid ); Group2^ myGroup = gcnew Group2; myGroup->Type = GroupType::Medium; TextWriter^ writer = gcnew StreamWriter( filename ); ser->Serialize( writer, myGroup ); writer->Close(); } void SerializeDateTime( String^ filename ) { XmlSerializer^ ser = gcnew XmlSerializer( Group3::typeid ); Group3^ myGroup = gcnew Group3; TextWriter^ writer = gcnew StreamWriter( filename ); ser->Serialize( writer, myGroup ); writer->Close(); } }; int main() { Test::main(); }
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
