XmlArrayItemAttribute.DataType プロパティ

[アーティクル]
03/28/2008

生成された XML 要素の XML データ型を取得または設定します。

Public Property DataType As String
[C#]
public string DataType {get; set;}
[C++]
public: __property String* get_DataType();public: __property void set_DataType(String*);
[JScript]
public function get DataType() : String;public function set DataType(String);

プロパティ値

World Wide Web Consortium (www.w3.org) のドキュメント『XML Schema Part 2: DataTypes』で定義されている XML スキーマ定義 (XSD) データ型。

解説

XML スキーマ単純データ型と、それに相当する .NET データ型の表を次に示します。

XML スキーマ base64Binary データ型と XML スキーマ hexBinary データ型の場合は、 Byte オブジェクトの配列を使用し、 DataType プロパティがデータ型に応じて "base64Binary" または "hexBinary" に設定されている XmlArrayItemAttribute を適用します。XML スキーマ time データ型と XML スキーマ date データ型の場合は、 DateTime 型を使用し、 DataType が "date" または "time" に設定されている XmlArrayItemAttribute を適用します。

文字列に割り当てられたすべての XML スキーマ型について、 DataType プロパティが XML スキーマ型に設定されている XmlArrayItemAttribute を適用します。ただし、これによってシリアル化形式が変更されることはなく、メンバのスキーマだけが変更されます。

メモプロパティは、大文字小文字を区別します。このため、各 XML スキーマデータ型を正確に設定する必要があります。

メモバイナリデータを XML 要素として渡すほうが、バイナリデータを XML 属性として渡すよりも効率的です。

XML スキーマデータ型の詳細については、World Wide Web Consortium (www.w3.org) のドキュメント『XML Schema Part 2: DataTypes』を参照してください。

XSD データ型	.NET データ型
anyURI	String
base64Binary	Byte オブジェクトの配列
boolean	Boolean
byte	SByte
date	DateTime
dateTime	DateTime
decimal	Decimal
double	Double
ENTITY	String
ENTITIES	String
float	Single
gDay	String
gMonth	String
gMonthDay	String
gYear	String
gYearMonth	String
hexBinary	Byte オブジェクトの配列
ID	String
IDREF	String
IDREFS	String
int	Int32
integer	String
language	String
long	Int64
Name	String
NCName	String
negativeInteger	String
NMTOKEN	String
NMTOKENS	String
normalizedString	String
nonNegativeInteger	String
nonPositiveInteger	String
NOTATION	String
positiveInteger	String
QName	XmlQualifiedName
duration	String
string	String
short	Int16
time	DateTime
token	String
unsignedByte	Byte
unsignedInt	UInt32
unsignedLong	UInt64
unsignedShort	UInt16

使用例

[Visual Basic, C#, C++] PurchaseOrder というクラスをシリアル化する例を次に示します。 XmlArrayItemAttribute クラスのいくつかのインスタンスが 3 つのメンバに適用され、各インスタンスの DataType プロパティが配列に設定できる型に設定されます。

 
Imports System
Imports System.Collections
Imports System.Xml
Imports System.Xml.Serialization
Imports System.IO
Imports System.Xml.Schema
Public Class PurchaseOrder
   <XmlArrayItem(DataType:= "gMonth", _
   ElementName:="MyMonths", _
   Namespace:= "http:'www.cohowinery.com")> _
   public Months() As String 

   <XmlArrayItem(GetType(Item)), XmlArrayItem(GetType(NewItem))> _
   public Items () As Item

   <XmlArray(IsNullable:= true), _
   XmlArrayItem(GetType(String)), _
   XmlArrayItem(GetType(double)), _
   XmlArrayItem(GetType(NewItem))> _
   public Things() As Object
End Class

Public Class Item
   public ItemID As String 

   public Sub New()
   End Sub
   
   public Sub New (id As String)
       ItemID = id
   End Sub
End Class

Public Class NewItem
   Inherits Item
   public Category As String 
   
   public Sub New()
      
   End Sub

   public Sub New(id As String , cat As String )
       me.ItemID = id
       Category = cat
   End Sub
End Class
 
Public Class Test
   Shared Sub Main()
      ' Read and write purchase orders.
      Dim t As Test = New Test()
      t.SerializeObject("ArrayItemExVB.xml")
      t.DeserializeObject("ArrayItemExVB.xml")
   End Sub 

   private Sub SerializeObject(filename As String)
      ' Create an instance of the XmlSerializer class
      ' specify the type of object to serialize.
      Dim serializer As XmlSerializer = _
      New XmlSerializer(GetType(PurchaseOrder))
      Dim writer As TextWriter = New StreamWriter(filename)
      ' Create a PurchaseOrder and set its properties.
      Dim po As PurchaseOrder =New PurchaseOrder()
      po.Months = New String() { "March", "May", "August"}
      po.Items= New Item(){New Item("a1"), New NewItem("b1", "book")}
      po.Things= New Object() {"String", 2003.31, New NewItem("Item100", "book")}
      
      ' Serialize the purchase order, and close the TextWriter.
      serializer.Serialize(writer, po)
      writer.Close()
   End Sub
 
   protected Sub DeserializeObject(filename As String)
      ' Create an instance of the XmlSerializer class
      ' specify the type of object to be deserialized.
      Dim serializer As XmlSerializer = _
      New XmlSerializer(GetType(PurchaseOrder))
   
      ' A FileStream is needed to read the XML document.
      Dim fs As FileStream = New FileStream(filename, FileMode.Open)
      ' Declare an object variable of the type to be deserialized.
      Dim po As PurchaseOrder 
      ' Use the Deserialize method to restore the object's state with
      ' data from the XML document. 
      po = CType( serializer.Deserialize(fs), PurchaseOrder)
      Dim s As String
      Dim i As Item
      Dim thing As Object
      for each s in po.Months
            Console.WriteLine(s)
      Next 
      
      for each i in po.Items
         Console.WriteLine(i.ItemID)
      Next 
      
      for each thing in po.Things
         Console.WriteLine(thing) 
      Next
   End Sub
End Class



[C#] 
using System;
using System.Collections;
using System.Xml;
using System.Xml.Serialization;
using System.IO;
using System.Xml.Schema;
public class PurchaseOrder
{
   [XmlArrayItem(DataType = "gMonth", 
   ElementName="MyMonths",
   Namespace = "http://www.cohowinery.com")]
   public string[] Months;

   [XmlArrayItem(typeof(Item)), XmlArrayItem(typeof(NewItem))]
   public Item[] Items;

   [XmlArray(IsNullable = true)]
   [XmlArrayItem(typeof(string)), 
   XmlArrayItem(typeof(double)), 
   XmlArrayItem(typeof(NewItem))]
   public object[] Things;
   }

public class Item{
   public string ItemID;
   public Item(){}
   public Item(string id){
       ItemID = id;
   }
}
public class NewItem:Item{
   public string Category;
   public NewItem(){}
   public NewItem(string id, string cat){
       this.ItemID = id;
       Category = cat;
       }
}
 
public class Test
{
   public static void Main()
   {
      // Read and write purchase orders.
      Test t = new Test();
      t.SerializeObject("ArrayItemEx.xml");
      t.DeserializeObject("ArrayItemEx.xml");
   } 

   private void SerializeObject(string filename)
   {
      // Create an instance of the XmlSerializer class;
      // specify the type of object to serialize.
      XmlSerializer serializer = 
      new XmlSerializer(typeof(PurchaseOrder));
      TextWriter writer = new StreamWriter(filename);
      // Create a PurchaseOrder and set its properties.
      PurchaseOrder po=new PurchaseOrder();
      po.Months = new string[]{ "March", "May", "August"};
      po.Items= new Item[]{new Item("a1"), new NewItem("b1", "book")};
      po.Things= new object[] {"String", 2003.31, new NewItem("Item100", "book")};
      
      // Serialize the purchase order, and close the TextWriter.
      serializer.Serialize(writer, po);
      writer.Close();
   }
 
   protected void DeserializeObject(string filename)
   {
      // Create an instance of the XmlSerializer class;
      // specify the type of object to be deserialized.
      XmlSerializer serializer = new XmlSerializer(typeof(PurchaseOrder));
   
      // A FileStream is needed to read the XML document.
      FileStream fs = new 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 = (PurchaseOrder) serializer.Deserialize(fs);
      foreach(string s in po.Months)
            Console.WriteLine(s);
      foreach(Item i in po.Items)
         Console.WriteLine(i.ItemID);
      foreach(object thing in po.Things)
         Console.WriteLine(thing); 
   } 
}


[C++] 
#using <mscorlib.dll>
#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 __gc class Item
{
public: 
   String* ItemID;
   Item(){}
   Item( String* id )
   {
      ItemID = id;
   }
};

public __gc class NewItem : public Item
{
public:
   String* Category;
   NewItem(){}
   NewItem(String* id, String* cat)
   {
      ItemID = id;
      Category = cat;
   }
};

public __gc class PurchaseOrder
{
public:
   [XmlArrayItem(DataType = "gMonth", 
      ElementName="MyMonths",
      Namespace = "http://www.cohowinery.com")]
   String*    Months[];

   [XmlArrayItem(__typeof(Item)), XmlArrayItem(__typeof(NewItem))]
   Item*    Items[];

   [XmlArray(IsNullable = true)]
   [XmlArrayItem(__typeof(String)), 
      XmlArrayItem(__typeof(Double)), 
      XmlArrayItem(__typeof(NewItem))]
   Object*    Things[];
};

void SerializeObject(String* filename)
{
   // Create an instance of the XmlSerializer class;
   // specify the type of object to serialize.
   XmlSerializer* serializer = 
      new XmlSerializer(__typeof(PurchaseOrder));
   TextWriter* writer = new StreamWriter(filename);
   // Create a PurchaseOrder and set its properties.
   PurchaseOrder* po = new PurchaseOrder();
   String*        months[] = {S"March", S"May", S"August"};
   po->Months = months;

   Item*        items[] = { new Item(S"a1"), new NewItem(S"b1", S"book")};
   po->Items= items;

   Object*        things[] = {S"String", __box( 2003.31 ), new NewItem(S"Item100", S"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 = new XmlSerializer(__typeof(PurchaseOrder));

   // A FileStream is needed to read the XML document.
   FileStream* fs = new 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 = __try_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");
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

XmlArrayItemAttribute クラス | XmlArrayItemAttribute メンバ | System.Xml.Serialization 名前空間

次の方法で共有

XmlArrayItemAttribute.DataType プロパティ

プロパティ値

解説

使用例

必要条件

参照

その他のリソース