Sdílet prostřednictvím


XmlTextAttribute.DataType Vlastnost

Definice

Získá nebo nastaví datový typ jazyka XSD (XML Schema Definition Language) textu vygenerovaného řetězcem 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

Datový typ schématu XML, který jste zadali, nelze namapovat na datový typ .NET.

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

Příklady

#using <System.Xml.dll>
#using <System.dll>

using namespace System;
using namespace System::Xml::Serialization;
using namespace System::IO;

public ref class Group1
{
public:

   // The XmlTextAttribute with type set to string informs the 
   // XmlSerializer that strings should be serialized as XML text.

   [XmlText(String::typeid)]
   [XmlElement(Int32::typeid)]
   [XmlElement(Double::typeid)]
   array<Object^>^All;
   Group1()
   {
      array<Object^>^temp = {321,"One",2,3.0,"Two"};
      All = temp;
   }
};

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

public ref class Group2
{
public:

   [XmlText(Type=GroupType::typeid)]
   GroupType Type;
};

public ref class Group3
{
public:

   [XmlText(Type=DateTime::typeid)]
   DateTime CreationTime;
   Group3()
   {
      CreationTime = DateTime::Now;
   }
};

public ref class Test
{
public:
   static void main()
   {
      Test^ t = gcnew Test;
      t->SerializeArray( "XmlText1.xml" );
      t->SerializeEnum( "XmlText2.xml" );
      t->SerializeDateTime( "XmlText3.xml" );
   }

private:
   void SerializeArray( String^ filename )
   {
      XmlSerializer^ ser = gcnew XmlSerializer( Group1::typeid );
      Group1^ myGroup1 = gcnew Group1;
      TextWriter^ writer = gcnew StreamWriter( filename );
      ser->Serialize( writer, myGroup1 );
      writer->Close();
   }

   void SerializeEnum( String^ filename )
   {
      XmlSerializer^ ser = gcnew XmlSerializer( Group2::typeid );
      Group2^ myGroup = gcnew Group2;
      myGroup->Type = GroupType::Medium;
      TextWriter^ writer = gcnew StreamWriter( filename );
      ser->Serialize( writer, myGroup );
      writer->Close();
   }

   void SerializeDateTime( String^ filename )
   {
      XmlSerializer^ ser = gcnew XmlSerializer( Group3::typeid );
      Group3^ myGroup = gcnew Group3;
      TextWriter^ writer = gcnew StreamWriter( filename );
      ser->Serialize( writer, myGroup );
      writer->Close();
   }
};

int main()
{
   Test::main();
}
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

DataType Nastavení vlastnosti na jednoduchý datový typ schématu XML ovlivňuje formát vygenerovaného XML. Například nastavení vlastnosti na "date" způsobí, že vygenerovaný text bude formátován v obecném stylu 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 kalendářních 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 definice schématu XML (Xsd.exe) k vygenerování schématu XML pro kompilovaný 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 DataType matici se sadou "base64Binary" nebo "hexBinary". U schématu time XML a datových typů použijte DateTime typ a date použijte ho XmlTextAttribute DataType se sadou na datum nebo čas.

U každého datového typu schématu XML, který je mapován na řetězec, použijte XmlTextAttribute vlastnost DataType 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 je citlivá na 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ž předání jako atribut XML.

Další informace o datových typech schémat XML naleznete v dokumentu 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
data a času. DateTime
decimal Decimal
double 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
language String
long Int64
Název String
Ncname String
negativeInteger String
NMTOKEN String
NMTOKENS String
normaldString String
nonNegativeInteger String
nonPositiveInteger String
ZÁPIS String
positiveInteger String
QName XmlQualifiedName
doba trvání String
řetězec String
short Int16
time DateTime
token String
unsignedByte Byte
unsignedInt UInt32
unsignedLong UInt64
unsignedShort UInt16

Platí pro