导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

XmlAttributeAttribute 类

2013/12/13

指定 XmlSerializer 必须将类成员序列化为 XML 属性。

System.Object
  System.Attribute
    System.Xml.Serialization.XmlAttributeAttribute

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

[AttributeUsageAttribute(AttributeTargets.Field|AttributeTargets.Parameter|AttributeTargets.Property|AttributeTargets.ReturnValue)]
public class XmlAttributeAttribute : Attribute

XmlAttributeAttribute 类型公开以下成员。

  名称说明
公共方法XmlAttributeAttribute()初始化 XmlAttributeAttribute 类的新实例。
公共方法XmlAttributeAttribute(String)初始化 XmlAttributeAttribute 类的新实例并指定所生成的 XML 属性的名称。
公共方法XmlAttributeAttribute(Type)初始化 XmlAttributeAttribute 类的新实例。
公共方法XmlAttributeAttribute(String, Type)初始化 XmlAttributeAttribute 类的新实例。
返回顶部

  名称说明
公共属性AttributeName获取或设置 XML 特性的名称。
公共属性DataType获取或设置由 XmlSerializer 生成的 XML 属性的 XSD 数据类型。
公共属性Form获取或设置一个值,该值指示 XmlSerializer 生成的 XML 属性名称是否为限定名称。
公共属性Namespace获取或设置 XML 特性的 XML 命名空间。
公共属性Type获取或设置 XML 特性的复杂类型。
返回顶部

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

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

当应用于公共字段或属性时,XmlAttributeAttribute 通知 XmlSerializer 将该成员作为 XML 特性序列化。默认情况下,XmlSerializer 将公共字段和属性作为 XML 元素序列化。

可将 XmlAttributeAttribute 只分配给这样的公共字段或公共属性:这些字段和属性返回一个值(或值的数组),该值可映射到一个 XML 架构定义 (XSD) 语言简单类型(包括从 XSD anySimpleType 类型派生的所有内置数据类型)。可能的类型包括可映射到 XSD 简单类型的任何类型,包括 GuidChar 和枚举。请参见 DataType 属性以查看 XSD 类型列表以及这些类型映射到 .NET 数据类型的方式。

利用 XmlAttributeAttribute 可设置两种特殊的特性:xml:lang(指定语言)和 xml:space(指定如何处理空格)特性。这些特性旨在传递仅与处理 XML 的应用程序有关的信息。下面的代码中显示了设置这些属性的示例。


[XmlAttribute("xml:lang")]
 public string Lang;
 // Set this to 'default' or 'preserve'.
 [XmlAttribute("space", 
 Namespace = "http://www.w3.org/XML/1998/namespace")]
 public string Space 

 [Visual Basic]
 <XmlAttribute("xml:lang")> _
 Public Lang As String 
 ' Set this to 'default' or 'preserve'.
 <XmlAttribute("space", _
 Namespace:= "http://www.w3.org/XML/1998/namespace")> _
 Public Space As String

说明注意:

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

Windows Phone OS

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

Windows Phone

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

显示:
© 2014 Microsoft