此页面有用吗?
您对此内容的反馈非常重要。 请告诉我们您的想法。
更多反馈?
1500 个剩余字符
导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

XmlArrayAttribute 类

2013/12/13

指定 XmlSerializer 必须将特定类成员序列化为 XML 元素的数组。

System.Object
  System.Attribute
    System.Xml.Serialization.XmlArrayAttribute

Namespace:  System.Xml.Serialization
程序集:  System.Xml(位于 System.Xml.dll 中)

[AttributeUsageAttribute(AttributeTargets.Field|AttributeTargets.Parameter|AttributeTargets.Property|AttributeTargets.ReturnValue, AllowMultiple = false)]
public class XmlArrayAttribute : Attribute

XmlArrayAttribute 类型公开以下成员。

  名称说明
公共方法XmlArrayAttribute()初始化 XmlArrayAttribute 类的新实例。
公共方法XmlArrayAttribute(String)初始化 XmlArrayAttribute 类的新实例并指定 XML 文档实例中生成的 XML 元素的名称。
返回顶部

  名称说明
公共属性ElementName获取或设置为序列化数组提供的 XML 元素名称。
公共属性Form获取或设置一个值,该值指示 XmlSerializer 生成的 XML 元素名称是限定名称还是非限定名称。
公共属性IsNullable获取或设置一个值,该值指示 XmlSerializer 是否必须将一个成员序列化为空 XML 元素,此元素具有设置为 truexsi:nil 特性。
公共属性Namespace获取或设置 XML 元素的命名空间。
公共属性Order获取或设置显式顺序,元素按照此顺序进行序列化或反序列化。
返回顶部

  名称说明
公共方法Equals基础结构。 返回一个值,该值指示此实例是否与指定的对象相等。 (从 Attribute 继承。)
受保护的方法Finalize允许 Object 在垃圾回收器回收该对象之前尝试释放资源并执行其他清理操作。 (从 Object 继承。)
公共方法GetHashCode返回此实例的哈希代码。 (从 Attribute 继承。)
公共方法GetType获取当前实例的 Type (从 Object 继承。)
公共方法Match当在派生类中重写时,返回一个指示此实例是否等于指定对象的值。 (从 Attribute 继承。)
受保护的方法MemberwiseClone创建当前 Object 的浅表副本。 (从 Object 继承。)
公共方法ToString返回一个字符串,它表示当前的对象。 (从 Object 继承。)
返回顶部

XmlArrayAttribute 属于一个特性系列,该系列控制 XmlSerializer 如何序列化或反序列化对象。

您可以将 XmlArrayAttribute 应用到返回对象的数组、集合或实现 IEnumerable 接口的任意类的公共字段或读/写属性。

XmlArrayAttribute 应用于类成员时,XmlSerializer 类的 Serialize 方法从该成员中生成嵌套的 XML 元素序列。一个 XML 架构文档(.xsd 文件),指示诸如 complexType 之类的数组。例如,如果要序列化的类表示一个采购订单,则可以通过将 XmlArrayAttribute 应用于返回表示定购项的对象数组的公共字段来生成采购项的数组。

如果没有将任何特性应用于返回复杂或基元类型对象数组的公共字段或属性,则默认情况下 XmlSerializer 生成嵌套的 XML 元素序列。若要更精确地控制生成何种 XML 元素,将 XmlArrayItemAttributeXmlArrayAttribute 应用于字段或属性。例如,默认情况下,生成的 XML 元素的名称从成员标识符中派生。您可以通过设置 ElementName 属性来更改生成的 XML 元素的名称。

如果序列化包含特定类型的项以及从该类型派生的所有类的数组,则必须使用 XmlArrayItemAttribute 来声明每个类型。

说明注意:

在代码中,可以使用 XmlArray 来代替较长的 XmlArrayAttribute

Windows Phone OS

受以下版本支持: 8.0, 7.1, 7.0

Windows Phone

此类型的所有公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

显示:
© 2015 Microsoft