XAttribute 类

定义

命名空间:

System.Xml.Linq

程序集:

System.Xml.XDocument.dll

程序集:

System.Xml.Linq.dll

程序集:

netstandard.dll

表示 XML 特性。

public ref class XAttribute : System::Xml::Linq::XObject

public class XAttribute : System.Xml.Linq.XObject

type XAttribute = class
    inherit XObject

Public Class XAttribute
Inherits XObject

继承

Object

XObject

XAttribute

注解

XML 属性是与 XML 元素关联的名称/值对。

每个 XElement 元素都包含该元素的属性列表。 属性必须具有对元素唯一的限定名称。 属性不派生自 XNode;它们不是 XML 树中的节点。 相反，它们只是与元素关联的名称/值对。

属性按添加到元素的顺序在 XML 树中维护。 当属性的集合返回 Attributes时，它们按添加到元素的顺序返回，并且不会排序。

从技术上说，在 XML 中，命名空间声明不是正确的属性。 但是，许多 XML 程序员通常不会进行这种区分。 相反，由于命名空间声明与属性完全相同，因此大多数 XML 程序员将命名空间视为属性。 为了简化LINQ to XML编程接口，命名空间在 XML 树中表示为属性。 此类命名空间属性会影响 XML 树的序列化。 序列化时，LINQ to XML尝试使用命名空间属性中指定的命名空间前缀进行序列化。 可以使用它 IsNamespaceDeclaration 来确定属性是否真的是命名空间声明。

XAttribute 类从 XObject 派生。 可以向属性添加批注，并观察它们的事件。

某些 XAttribute 方法可从 XAML 使用。 有关详细信息，请参阅 LINQ to XML 动态属性。

构造函数

XAttribute(XAttribute)	从其他 XAttribute 对象初始化 XAttribute 类的新实例。
XAttribute(XName, Object)	从指定的名称和值初始化 XAttribute 类的新实例。

属性

BaseUri	获取此 XObject 的基 URI。 (继承自 XObject)
Document	获取此 XDocument 的 XObject。 (继承自 XObject)
EmptySequence	获取空的属性集合。
IsNamespaceDeclaration	确定此属性是否为命名空间声明。
Name	获取此属性的扩展名。
NextAttribute	获取父元素的下一个属性。
NodeType	获取此节点的节点类型。
Parent	获取此 XObject 的父级 XElement。 (继承自 XObject)
PreviousAttribute	获取父元素的上一个属性。
Value	获取或设置此属性的值。

方法

AddAnnotation(Object)	将对象添加到此 XObject 的批注列表。 (继承自 XObject)
Annotation(Type)	从此 XObject 获取指定类型的第一个批注对象。 (继承自 XObject)
Annotation<T>()	从此 XObject 获取指定类型的第一个批注对象。 (继承自 XObject)
Annotations(Type)	获取此 XObject 的指定类型的批注集合。 (继承自 XObject)
Annotations<T>()	获取此 XObject 的指定类型的批注集合。 (继承自 XObject)
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
Remove()	将此属性从父元素中移除。
RemoveAnnotations(Type)	从此 XObject 移除指定类型的批注。 (继承自 XObject)
RemoveAnnotations<T>()	从此 XObject 移除指定类型的批注。 (继承自 XObject)
SetValue(Object)	设置此属性的值。
ToString()	将当前的 XAttribute 对象转换为字符串表示形式。

运算符

Explicit(XAttribute to Boolean)	将此 XAttribute 的值强制转换为 Boolean。
Explicit(XAttribute to DateTime)	将此 XAttribute 的值强制转换为 DateTime。
Explicit(XAttribute to DateTimeOffset)	将此 XAttribute 的值强制转换为 DateTimeOffset。
Explicit(XAttribute to Decimal)	将此 XAttribute 的值强制转换为 Decimal。
Explicit(XAttribute to Double)	将此 XAttribute 的值强制转换为 Double。
Explicit(XAttribute to Guid)	将此 XAttribute 的值强制转换为 Guid。
Explicit(XAttribute to Int32)	将此 XAttribute 的值强制转换为 Int32。
Explicit(XAttribute to Int64)	将此 XAttribute 的值强制转换为 Int64。
Explicit(XAttribute to Nullable<Boolean>)	将此 XAttribute 的值强制转换为 Boolean 的 Nullable<T>。
Explicit(XAttribute to Nullable<DateTime>)	将此 XAttribute 的值强制转换为 DateTime 的 Nullable<T>。
Explicit(XAttribute to Nullable<DateTimeOffset>)	将此 XAttribute 的值强制转换为 DateTimeOffset 的 Nullable<T>。
Explicit(XAttribute to Nullable<Decimal>)	将此 XAttribute 的值强制转换为 Decimal 的 Nullable<T>。
Explicit(XAttribute to Nullable<Double>)	将此 XAttribute 的值强制转换为 Double 的 Nullable<T>。
Explicit(XAttribute to Nullable<Guid>)	将此 XAttribute 的值强制转换为 Guid 的 Nullable<T>。
Explicit(XAttribute to Nullable<Int32>)	将此 XAttribute 的值强制转换为 Int32 的 Nullable<T>。
Explicit(XAttribute to Nullable<Int64>)	将此 XAttribute 的值强制转换为 Int64 的 Nullable<T>。
Explicit(XAttribute to Nullable<Single>)	将此 XAttribute 的值强制转换为 Single 的 Nullable<T>。
Explicit(XAttribute to Nullable<TimeSpan>)	将此 XAttribute 的值强制转换为 TimeSpan 的 Nullable<T>。
Explicit(XAttribute to Nullable<UInt32>)	将此 XAttribute 的值强制转换为 UInt32 的 Nullable<T>。
Explicit(XAttribute to Nullable<UInt64>)	将此 XAttribute 的值强制转换为 UInt64 的 Nullable<T>。
Explicit(XAttribute to Single)	将此 XAttribute 的值强制转换为 Single。
Explicit(XAttribute to String)	将此 XAttribute 的值强制转换为 String。
Explicit(XAttribute to TimeSpan)	将此 XAttribute 的值强制转换为 TimeSpan。
Explicit(XAttribute to UInt32)	将此 XAttribute 的值强制转换为 UInt32。
Explicit(XAttribute to UInt64)	将此 XAttribute 的值强制转换为 UInt64。

事件

Changed	在此 XObject 或其任何子代发生了更改时引发。 (继承自 XObject)
Changing	当此 XObject 或其任何子代要发生更改时引发。 (继承自 XObject)

显式接口实现

IXmlLineInfo.HasLineInfo()	获取一个值，该值指示此 XObject 是否具有行信息。 (继承自 XObject)
IXmlLineInfo.LineNumber	获取基础 XmlReader 为此 XObject 报告的行号。 (继承自 XObject)
IXmlLineInfo.LinePosition	获取基础 XmlReader 为此 XObject 报告的行位置。 (继承自 XObject)

扩展方法

GetSchemaInfo(XAttribute)	获取已验证特性的架构验证后信息集 (PSVI)。
Validate(XAttribute, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler)	此方法验证 XAttribute 是否与指定的 XmlSchemaObject 和 XmlSchemaSet 相符。
Validate(XAttribute, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler, Boolean)	验证 XAttribute 是否与指定的 XmlSchemaObject 和 XmlSchemaSet 相符，并且可以选择使用架构验证后信息集 (PSVI) 填充 XML 树。

另请参阅

• XElement
• XDocument
• LINQ to XML 概述
• XAttribute 类概述
• LINQ to XML 动态属性