XmlArrayItemAttribute::DataType Property
Gets or sets the XML data type of the generated XML element.
Assembly: System.Xml (in System.Xml.dll)
Property Value
Type: System::String^An XML schema definition (XSD) data type, as defined by the World Wide Web Consortium (www.w3.org) document "XML Schema Part 2: DataTypes".
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 objects, and apply an XmlArrayItemAttribute with the DataType property set to "base64Binary" or "hexBinary", as appropriate. For the XML Schema time and date data types, use the DateTime type and apply the XmlArrayItemAttribute with the DataType set to "date" or "time".
For every XML Schema type that is mapped to a string, apply the XmlArrayItemAttribute with its DataType property set to the XML Schema type. However, 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 then passing it as an XML attribute. |
For more information about XML Schema data types, see the World Wide Web Consortium (www.w3.org) document "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 |
The following example serializes a class named PurchaseOrder. Several instances of the XmlArrayItemAttribute class are applied to three members, and the DataType property for each instance is set to a type allowed in the array.
#using <System.dll> #using <System.xml.dll> using namespace System; using namespace System::Collections; using namespace System::Xml; using namespace System::Xml::Serialization; using namespace System::IO; using namespace System::Xml::Schema; public ref class Item { public: String^ ItemID; Item(){} Item( String^ id ) { ItemID = id; } }; public ref class NewItem: public Item { public: String^ Category; NewItem(){} NewItem( String^ id, String^ cat ) { ItemID = id; Category = cat; } }; public ref class PurchaseOrder { public: [XmlArrayItem(DataType="gMonth", ElementName="MyMonths", Namespace="http://www.cohowinery.com")] array<String^>^Months; [XmlArrayItem(Item::typeid),XmlArrayItem(NewItem::typeid)] array<Item^>^Items; [XmlArray(IsNullable=true)] [XmlArrayItem(String::typeid), XmlArrayItem(Double::typeid), XmlArrayItem(NewItem::typeid)] array<Object^>^Things; }; void SerializeObject( String^ filename ) { // Create an instance of the XmlSerializer class; // specify the type of object to serialize. XmlSerializer^ serializer = gcnew XmlSerializer( PurchaseOrder::typeid ); TextWriter^ writer = gcnew StreamWriter( filename ); // Create a PurchaseOrder and set its properties. PurchaseOrder^ po = gcnew PurchaseOrder; array<String^>^months = {"March","May","August"}; po->Months = months; array<Item^>^items = {gcnew Item( "a1" ),gcnew NewItem( "b1","book" )}; po->Items = items; array<Object^>^things = {"String",2003.31,gcnew NewItem( "Item100","book" )}; po->Things = things; // Serialize the purchase order, and close the TextWriter. serializer->Serialize( writer, po ); writer->Close(); } void DeserializeObject( String^ filename ) { // Create an instance of the XmlSerializer class; // specify the type of object to be deserialized. XmlSerializer^ serializer = gcnew XmlSerializer( PurchaseOrder::typeid ); // A FileStream is needed to read the XML document. FileStream^ fs = gcnew FileStream( filename,FileMode::Open ); // Declare an object variable of the type to be deserialized. PurchaseOrder^ po; /* Use the Deserialize method to restore the object's state with data from the XML document. */ po = safe_cast<PurchaseOrder^>(serializer->Deserialize( fs )); for ( int i = 0; i < po->Months->Length; ++i ) Console::WriteLine( po->Months[ i ] ); for ( int i = 0; i < po->Items->Length; ++i ) Console::WriteLine( po->Items[ i ]->ItemID ); for ( int i = 0; i < po->Things->Length; ++i ) Console::WriteLine( po->Things[ i ] ); } int main() { // Read and write purchase orders. SerializeObject( "ArrayItemEx.xml" ); DeserializeObject( "ArrayItemEx.xml" ); }
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
