XmlElementAttribute.DataType 属性

参考

定义

命名空间:: System.Xml.Serialization

程序集:: System.Xml.XmlSerializer.dll

程序集:: System.Xml.ReaderWriter.dll

程序集:: System.Xml.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

获取或设置由 XmlSerializer 生成的 XMl 元素的 XML 架构定义 (XSD) 数据类型。

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

属性值

String

XML 架构数据类型。

例外

Exception

已指定的 XML 架构数据类型无法映射到 .NET 数据类型。

示例

以下示例序列化一个名为的类，该类包含名为 Group 的 ExtraInfo字段，该字段返回一个 ArrayList。本示例对字段应用两个实例 XmlElementAttribute ，并为每个实例指定不同的 DataType 值。每个实例都允许 XmlSerializer 序列化插入到数组中的指定类型。

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

using namespace System;
using namespace System::Collections;
using namespace System::IO;
using namespace System::Xml::Serialization;
public ref class Group
{
public:

   /* Apply two XmlElementAttributes to the field. Set the DataType
      to string an int to allow the ArrayList to accept 
      both types. The Namespace is also set to different values
      for each type. */

   [XmlElement(DataType="string",
   Type=String::typeid,
   Namespace="http://www.cpandl.com"),
   XmlElement(DataType="snippet1>",
   Namespace="http://www.cohowinery.com",
   Type=Int32::typeid)]
   ArrayList^ ExtraInfo;
};

void SerializeObject( String^ filename )
{
   // A TextWriter is needed to write the file.
   TextWriter^ writer = gcnew StreamWriter( filename );

   // Create the XmlSerializer using the XmlAttributeOverrides.
   XmlSerializer^ s = gcnew XmlSerializer( Group::typeid );

   // Create the object to serialize.
   Group^ myGroup = gcnew Group;

   /* Add a string and an integer to the ArrayList returned
      by the ExtraInfo field. */
   myGroup->ExtraInfo = gcnew ArrayList;
   myGroup->ExtraInfo->Add( "hello" );
   myGroup->ExtraInfo->Add( 100 );

   // Serialize the object and close the TextWriter.
   s->Serialize( writer, myGroup );
   writer->Close();
}

int main()
{
   SerializeObject( "ElementTypes.xml" );
}

using System;
using System.Collections;
using System.IO;
using System.Xml.Serialization;

public class Group
{
   /* Apply two XmlElementAttributes to the field. Set the DataType
      to string an int to allow the ArrayList to accept
      both types. The Namespace is also set to different values
      for each type. */
   [XmlElement(DataType = "string",
   Type = typeof(string),
   Namespace = "http://www.cpandl.com"),
   XmlElement(DataType = "int",
   Namespace = "http://www.cohowinery.com",
   Type = typeof(int))]
   public ArrayList ExtraInfo;
}

public class Run
{
    public static void Main()
    {
       Run test = new Run();
       test.SerializeObject("ElementTypes.xml");
          }

    public void SerializeObject(string filename)
    {
      // A TextWriter is needed to write the file.
      TextWriter writer = new StreamWriter(filename);

      // Create the XmlSerializer using the XmlAttributeOverrides.
      XmlSerializer s =
      new XmlSerializer(typeof(Group));

      // Create the object to serialize.
      Group myGroup = new Group();

      /* Add a string and an integer to the ArrayList returned
         by the ExtraInfo field. */
      myGroup.ExtraInfo = new ArrayList();
      myGroup.ExtraInfo.Add("hello");
      myGroup.ExtraInfo.Add(100);

      // Serialize the object and close the TextWriter.
      s.Serialize(writer,myGroup);
      writer.Close();
   }
}

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


Public Class Group
    ' Apply two XmlElementAttributes to the field. Set the DataType
    ' to string and int to allow the ArrayList to accept
    ' both types. The Namespace is also set to different values
    ' for each type. 
    <XmlElement(DataType := "string", _
        Type := GetType(String), _
        Namespace := "http://www.cpandl.com"), _
     XmlElement(DataType := "int", _                    
        Type := GetType(Integer), _
        Namespace := "http://www.cohowinery.com")> _
    Public ExtraInfo As ArrayList
End Class


Public Class Run
    
    Public Shared Sub Main()
        Dim test As New Run()
        test.SerializeObject("ElementTypes.xml")
    End Sub    
    
    Public Sub SerializeObject(filename As String)
        ' A TextWriter is needed to write the file.
        Dim writer As New StreamWriter(filename)
        
        ' Create the XmlSerializer using the XmlAttributeOverrides.
        Dim s As New XmlSerializer(GetType(Group))
        
        ' Create the object to serialize.
        Dim myGroup As New Group()
        
        ' Add a string and an integer to the ArrayList returned
        ' by the ExtraInfo field. 
        myGroup.ExtraInfo = New ArrayList()
        myGroup.ExtraInfo.Add("hello")
        myGroup.ExtraInfo.Add(100)
        
        ' Serialize the object and close the TextWriter.
        s.Serialize(writer, myGroup)
        writer.Close()
    End Sub
End Class

注解

下表列出了具有 their.NET 等效项的 XML 架构简单数据类型。

对于 XML 架构base64Binary和hexBinary数据类型，请使用结构数组Byte，并根据需要将XmlElementAttribute DataType集应用于“base64Binary”或“hexBinary”。对于 XML 架构time和date数据类型，请使用该DateTime类型并将集应用于XmlElementAttribute DataType“date”或“time”。

对于映射到字符串的每个 XML 架构类型，请将 XmlElementAttribute 其 DataType 属性设置为 XML 架构类型。这可以更改序列化格式，而不仅仅是成员的架构。

备注

该属性区分大小写，因此必须将其完全设置为 XML 架构数据类型之一。

备注

将二进制数据作为 XML 元素传递比作为 XML 架构属性传递更有效。

有关 XML 数据类型的详细信息，请参阅名为 XML 架构第 2 部分的万维网联盟文档：数据类型。

XSD 数据类型	.NET 数据类型
anyURI	String
base64Binary	Byte 对象的数组
boolean	Boolean
字节	SByte
日期	DateTime
dateTime	DateTime
Decimal	Decimal
Double	Double
ENTITY	String
实体	String
FLOAT	Single
gDay	String
gMonth	String
gMonthDay	String
gYear	String
gYearMonth	String
hexBinary	Byte 对象的数组
ID	String
IDREF	String
IDREFS	String
int	Int32
整型	String
语言	String
long	Int64
“属性”	String
NCName	String
negativeInteger	String
NMTOKEN	String
NMTOKENS	String
normalizedString	String
nonNegativeInteger	String
nonPositiveInteger	String
NOTATION	String
positiveInteger	String
QName	XmlQualifiedName
duration	String
字符串	String
short	Int16
time	DateTime
令牌	String
unsignedByte	Byte
unsignedInt	UInt32
unsignedLong	UInt64
unsignedShort	UInt16

适用于

通过

XmlElementAttribute.DataType 属性

定义

属性值

例外

示例

注解

适用于

其他资源