XmlTextAttribute.DataType Eigenschaft

public:
 property System::String ^ DataType { System::String ^ get(); void set(System::String ^ value); };

public string DataType { get; set; }

member this.DataType : string with get, set

Public Property DataType As String

Eigenschaftswert

Ein XML-Schemadatentyp (XSD).

Ausnahmen

Beispiele

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

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

Hinweise

Das Festlegen der DataType Eigenschaft auf einen einfachen XML-Schemadatentyp wirkt sich auf das Format des generierten XML-Codes aus. Das Festlegen der Eigenschaft auf "Date" bewirkt beispielsweise, dass der generierte Text im allgemeinen Datumsformat formatiert wird, z. B. 2001-08-31. Im Gegensatz dazu führt das Festlegen der Eigenschaft auf "dateTime" zu einem bestimmten Augenblick, der durch das Dokument "International Organization for Standardization" 8601 definiert wurde, "Representations of Dates and Times", z. B. 2001-08-15T06:59:11.0508456-07:00.

Die Auswirkung der Einstellung der DataType Eigenschaft kann auch bei Verwendung des XML-Schemadefinitionstools (Xsd.exe) zum Generieren des XML-Schemas für eine kompilierte Datei angezeigt werden. Weitere Informationen zur Verwendung des Tools finden Sie im XML-Schemadefinitionstool und der XML-Serialisierung.

In der folgenden Tabelle sind die einfachen XML-Schema-Datentypen mit ihren .NET-Entsprechungen aufgeführt.

Verwenden Sie für das XML-Schema base64Binary und hexBinary die Datentypen ein Array von Byte Strukturen, und wenden Sie einen XmlTextAttribute mit dem DataType Satz auf "base64Binary" oder "hexBinary" an, sofern zutreffend. Verwenden Sie für das XML-Schema time und date die Datentypen den DateTime Typ, und wenden Sie den XmlTextAttributeDataType Mitsatz auf "Datum" oder "Uhrzeit" an.

Wenden Sie für jeden XML-Schemadatentyp, der einer Zeichenfolge zugeordnet ist, die XmlTextAttribute Eigenschaft DataType auf den XML-Schemadatentyp an. Beachten Sie, dass dadurch das Serialisierungsformat nicht geändert wird, nur das Schema für das Element.

Weitere Informationen zu XML-Schemadatentypen finden Sie im World Wide Web Consortium-Dokument mit dem Namen "XML Schema Part 2: Datatypes".