XmlTextAttribute.DataType プロパティ

XmlSerializer によって生成されたテキストの XML スキーマ定義言語 (XSD: XML Schema Definition Language) データ型を取得または設定します。

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);

プロパティ値

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

例外

解説

DataType プロパティに XML スキーマの単純データ型を設定すると、生成される XML の書式が影響を受けます。たとえば、このプロパティに "date" を設定すると、生成されるテキストの書式は汎用的な日付スタイル (2001-08-31 など) になります。それとは対照的に、このプロパティに "dateTime" を設定すると、ISO (International Organization for Standardization) のドキュメント 8601、『Representations of Dates and Times』で定義されているような、特定の瞬間を表す書式 (2001-08-15T06:59:11.0508456-07:00) になります。

DataType プロパティの設定による影響は、 XML スキーマ定義ツール (Xsd.exe) を使用して、コンパイル済みファイル用の XML スキーマを生成する場合にも及びます。このツールの使用方法については、「 XML スキーマ定義ツールと XML シリアル化 」を参照してください。

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

XML スキーマの base64Binary データ型と hexBinary データ型については、 Byte 構造体の配列を使用し、 DataType をそれぞれ "base64Binary" または "hexBinary" に設定した XmlTextAttribute を適用します。XML スキーマの time データ型と date データ型については、 DateTime 型を使用して、 DataType を "date" または "time" に設定した XmlTextAttribute を適用します。

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

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

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

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

使用例

 
Imports System
Imports System.Xml.Serialization
Imports System.IO


Public Class Group1
   ' The XmlTextAttribute with type set to String informs the 
   ' XmlSerializer that strings should be serialized as XML text.
   <XmlText(GetType(String)), _
   XmlElement(GetType(integer)), _  
   XmlElement(GetType(double))> _
   public All () As Object = _
   New Object (){321, "One", 2, 3.0, "Two" }
End Class


Public Class Group2
   <XmlText(GetType(GroupType))> _
   public Type As GroupType 
End Class

Public Enum GroupType
   Small
   Medium
   Large
End Enum

Public Class Group3
   <XmlText(GetType(DateTime))> _
   Public CreationTime As DateTime = DateTime.Now
End Class

Public Class Test
   Shared Sub Main()
      Dim t As Test = New Test()
      t.SerializeArray("XmlText1.xml")
      t.SerializeEnum("XmlText2.xml")
      t.SerializeDateTime("XmlText3.xml")
   End Sub

   Private Sub SerializeArray(filename As String)
      Dim ser As XmlSerializer = New XmlSerializer(GetType(Group1))
      Dim myGroup1 As Group1 = New Group1()

      Dim writer As TextWriter = New StreamWriter(filename)

      ser.Serialize(writer, myGroup1)
      writer.Close()
   End Sub

   Private Sub SerializeEnum(filename As String)
      Dim ser As XmlSerializer = New XmlSerializer(GetType(Group2))
      Dim myGroup As Group2 = New Group2()
      myGroup.Type = GroupType.Medium
      Dim writer As TextWriter = New StreamWriter(filename)

      ser.Serialize(writer, myGroup)
      writer.Close()
   End Sub

   Private Sub SerializeDateTime(filename As String)
      Dim ser As XmlSerializer = new XmlSerializer(GetType(Group3))
      Dim myGroup As Group3 = new Group3()
      Dim writer As TextWriter = new StreamWriter(filename)

      ser.Serialize(writer, myGroup)
      writer.Close()
   End Sub
End Class

[C#] 
using System;
using System.Xml.Serialization;
using System.IO;


public class Group1{
   // The XmlTextAttribute with type set to string informs the 
   // XmlSerializer that strings should be serialized as XML text.
   [XmlText(typeof(string))]
   [XmlElement(typeof(int))]  
   [XmlElement(typeof(double))]
   public object [] All= new object []{321, "One", 2, 3.0, "Two" };
}

public class Group2{
   [XmlText(Type = typeof(GroupType))]
   public GroupType Type;
}
public enum GroupType{
   Small,
   Medium,
   Large
}

public class Group3{
   [XmlText(Type=typeof(DateTime))]
   public DateTime CreationTime = DateTime.Now;
}

public class Test{
   static void Main(){
      Test t = new Test();
      t.SerializeArray("XmlText1.xml");
      t.SerializeEnum("XmlText2.xml");
      t.SerializeDateTime("XmlText3.xml");
   }

   private void SerializeArray(string filename){
      XmlSerializer ser = new XmlSerializer(typeof(Group1));
      Group1 myGroup1 = new Group1();

      TextWriter writer = new StreamWriter(filename);

      ser.Serialize(writer, myGroup1);
      writer.Close();
   }

   private void SerializeEnum(string filename){
      XmlSerializer ser = new XmlSerializer(typeof(Group2));
      Group2 myGroup = new Group2();
      myGroup.Type = GroupType.Medium;
      TextWriter writer = new StreamWriter(filename);

      ser.Serialize(writer, myGroup);
      writer.Close();
   }

   private void SerializeDateTime(string filename){
      XmlSerializer ser = new XmlSerializer(typeof(Group3));
      Group3 myGroup = new Group3();
      TextWriter writer = new StreamWriter(filename);

      ser.Serialize(writer, myGroup);
      writer.Close();
   }   
}

[C++] 
#using <mscorlib.dll>
#using <System.Xml.dll>
#using <System.dll>
using namespace System;
using namespace System::Xml::Serialization;
using namespace System::IO;


public __gc class Group1{
   // The XmlTextAttribute with type set to string informs the 
   // XmlSerializer that strings should be serialized as XML text.
public:
   [XmlText(__typeof(String))]
   [XmlElement(__typeof(Int32))]  
   [XmlElement(__typeof(Double))]
   Object* All[];
   Group1(){
      Object* temp[]= {__box(321), S"One", __box(2), __box(3.0), S"Two" };
      All = temp;
   }
};

public __value enum GroupType{
   Small,
   Medium,
   Large
};

public __gc class Group2{
public:
   [XmlText(Type = __typeof(GroupType))]
   GroupType Type;
};

public __gc class Group3{
public:
   [XmlText(Type=__typeof(DateTime))]
   DateTime CreationTime;
   Group3(){
      CreationTime = DateTime::Now;
   }
};

public __gc class Test{
public:
   static void main(){
      Test* t = new Test();
      t->SerializeArray(S"XmlText1.xml");
      t->SerializeEnum(S"XmlText2.xml");
      t->SerializeDateTime(S"XmlText3.xml");
   }

private:
   void SerializeArray(String* filename){
      XmlSerializer* ser = new XmlSerializer(__typeof(Group1));
      Group1* myGroup1 = new Group1();

      TextWriter* writer = new StreamWriter(filename);

      ser->Serialize(writer, myGroup1);
      writer->Close();
   }

   void SerializeEnum(String* filename){
      XmlSerializer* ser = new XmlSerializer(__typeof(Group2));
      Group2* myGroup = new Group2();
      myGroup->Type = GroupType::Medium;
      TextWriter* writer = new StreamWriter(filename);

      ser->Serialize(writer, myGroup);
      writer->Close();
   }

   void SerializeDateTime(String* filename){
      XmlSerializer* ser = new XmlSerializer(__typeof(Group3));
      Group3* myGroup = new Group3();
      TextWriter* writer = new StreamWriter(filename);

      ser->Serialize(writer, myGroup);
      writer->Close();
   }   
};

int main()
{
   Test::main();
}

[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

参照

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