XmlTextAttribute.DataType Propriedade

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

Valor de Propriedade

Um tipo de dado XML Schema (XSD).

Exceções

Exemplos

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

Observações

Definir a DataType propriedade para um tipo de dado simples de XML Schema afeta o formato do XML gerado. Por exemplo, definir a propriedade como "date" faz com que o texto gerado seja formatado no estilo geral de data, por exemplo: 2001-08-31. Em contraste, definir a propriedade para "dateTime" resulta num instante específico conforme definido pelo documento 8601 da Organização Internacional de Normalização, "Representações de Datas e Horários", por exemplo: 2001-08-15T06:59:11.0508456-07:00.

O efeito de definir a DataType propriedade também pode ser observado ao usar a Ferramenta de Definição de Esquema XML (Xsd.exe) para gerar o Esquema XML para um ficheiro compilado. Para mais informações sobre a utilização da ferramenta, consulte A Ferramenta de Definição de Esquemas XML e Serialização XML.

A tabela seguinte lista os tipos de dados simples do XML Schema com os seus equivalentes .NET.

Para o XML Schema base64Binary e hexBinary tipos de dados, use um array de Byte estruturas e aplique XmlTextAttribute a com o DataType conjunto para "base64Binary" ou "hexBinary", conforme apropriado. Para o XML Schema time e date tipos de dados, use o DateTime tipo e aplique o XmlTextAttribute com DataType o conjunto como "data" ou "hora".

Para cada tipo de dado XML Schema que seja mapeado para uma cadeia, aplique o XmlTextAttribute com a sua DataType propriedade definida ao tipo de dado XML Schema. Note que isto não altera o formato de serialização, apenas o esquema do membro.

Para mais informações sobre os tipos de dados XML Schema, consulte o documento do World Wide Web Consortium chamado XML Schema Part 2: Datatypes.