XmlArrayItemAttribute 类

2013/12/13

指定 XmlSerializer 可以放置在序列化数组中的派生类型。

System.Object
  System.Attribute
    System.Xml.Serialization.XmlArrayItemAttribute

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

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

XmlArrayItemAttribute 类型公开以下成员。

  名称说明
公共方法XmlArrayItemAttribute()初始化 XmlArrayItemAttribute 类的新实例。
公共方法XmlArrayItemAttribute(String)初始化 XmlArrayItemAttribute 类的新实例并指定 XML 文档中生成的 XML 元素的名称。
公共方法XmlArrayItemAttribute(Type)初始化 XmlArrayItemAttribute 类的新实例,并指定可以插入到已序列化数组中的 Type
公共方法XmlArrayItemAttribute(String, Type)初始化 XmlArrayItemAttribute 类的新实例,并为 XML 文档中生成的 XML 元素以及可以插入到生成的 XML 文档中的 Type 指定名称。
返回顶部

  名称说明
公共属性DataType获取或设置生成的 XML 元素的 XML 数据类型。
公共属性ElementName获取或设置生成的 XML 元素的名称。
公共属性Form获取或设置一个值,指示生成的 XML 元素的名称是否为限定名称。
公共属性IsNullable获取或设置一个值,该值指示 XmlSerializer 是否必须将一个成员序列化为空 XML 标记,此元素具有设置为 truexsi:nil 特性。
公共属性Namespace获取或设置生成的 XML 元素的命名空间。
公共属性NestingLevel获取或设置受 XmlArrayItemAttribute 影响的 XML 元素的层次结构中的级别。
公共属性Type获取或设置数组中允许的类型。
返回顶部

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

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

可以将 XmlArrayItemAttribute 应用到任何返回数组的公共读/写成员,或者提供对其中一个成员的访问。例如,返回对象数组的字段、集合、或任何实现 IEnumerable 接口的类。

XmlArrayItemAttribute 支持多态,即它允许 XmlSerializer 将派生对象添加到数组中。例如,假设一个名为 Mammal 的类派生自名为 Animal 的基类。进一步假设名为 MyAnimals 的类包含一个返回 Animal 对象的数组的字段。若要允许 XmlSerializer 既可序列化 Animal 类型,又可序列化 Mammal 类型,可将 XmlArrayItemAttribute 两次应用于该字段,每次指定两个可接受类型中的一个。

说明注意:

可以应用 XmlArrayItemAttributeXmlElementAttribute 的多个实例,以指定可插入数组的对象类型。

说明注意:

对于返回接口或接口数组的字段或属性而言,不支持对其进行序列化。

说明注意:

在代码中,可以使用单词 XmlArrayItem 来代替较长的 XmlArrayItemAttribute

Windows Phone OS

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

Windows Phone

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

显示:
© 2014 Microsoft