XmlTextAttribute.DataType Vlastnost

Definice

Obor názvů:

System.Xml.Serialization

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zdroj:

XmlTextAttribute.cs

Získá nebo nastaví jazyk XSD (XML Schema definition Language) datový typ textu vygenerovaného XmlSerializer.

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

Hodnota vlastnosti

String

Datový typ schématu XML (XSD).

Výjimky

Exception

Zadaný datový typ schématu XML nelze mapovat na datový typ .NET.

InvalidOperationException

Datový typ schématu XML, který jste zadali, je pro vlastnost neplatný a nelze jej převést na typ členu.

Příklady

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

Poznámky

Nastavení vlastnosti na DataType jednoduchý datový typ schématu XML má vliv na formát vygenerovaného XML. Například nastavení vlastnosti na "date" způsobí, že vygenerovaný text bude formátován v obecném stylu kalendářního data, například: 2001-08-31. Nastavení vlastnosti dateTime naopak vede k určitému okamžiku definovanému dokumentem Mezinárodní organizace pro standardizaci 8601, "Reprezentace dat a časů", například: 2001-08-15T06:59:11.0508456-07:00.

Účinek nastavení DataType vlastnosti lze také vidět při použití nástroje pro definici schématu XML (Xsd.exe) k vygenerování schématu XML pro zkompilovaný soubor. Další informace o použití nástroje naleznete v tématu Nástroj definice schématu XML a serializace XML.

Následující tabulka uvádí jednoduché datové typy schématu XML s jejich ekvivalenty .NET.

V případě schématu base64Binary XML a hexBinary datových Byte typů použijte pole struktur a podle potřeby použijte XmlTextAttribute pole se DataType sadou "base64Binary" nebo "hexBinary". Pro schéma time XML a date datové typy použijte DateTime typ a použijte XmlTextAttribute s DataType nastaveným datem nebo časem.

Pro každý datový typ schématu XML, který je namapován na řetězec, použijte XmlTextAttribute s jeho DataType vlastností nastavenou na datový typ schématu XML. Všimněte si, že se tím nezmění formát serializace, pouze schéma člena.

Poznámka:

Vlastnost rozlišují malá a velká písmena, takže ji musíte nastavit přesně na jeden z datových typů schématu XML.

Poznámka:

Předávání binárních dat jako elementu XML je efektivnější než jeho předání jako atribut XML.

Další informace o datových typech schématu XML naleznete v dokumentu konsorcia World Wide Web Consortium s názvem XML Schema Part 2: Datatypes.

Datový typ XSD	Datový typ .NET
Anyuri	String
Base64binary	Byte Pole objektů
Boolean	Boolean
byte	SByte
date	DateTime
datum a čas	DateTime
desítkové číslo	Decimal
dvojitý	Double
ENTITY	String
ENTITY	String
float	Single
gDay	String
gMonth	String
gMonthDay	String
gYear	String
gYearMonth	String
Hexbinary	Byte Pole objektů
ID	String
IDREF	String
IDREFS	String
int	Int32
integer	String
jazyk	String
long	Int64
název	String
Ncname	String
negativeInteger	String
NMTOKEN	String
NMTOKENS	String
normalizedString	String
nonNegativeInteger	String
nonPositiveInteger	String
ZÁPIS	String
positiveInteger	String
QName	XmlQualifiedName
duration	String
řetězec	String
short	Int16
time	DateTime
token	String
bezznaménkový bajt	Byte
neznačené celé číslo	UInt32
unsignedLong	UInt64
unsignedShort (nepodepsaný krátký)	UInt16