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	取得這個屬性的擴展名稱 (Expanded Name)。
NextAttribute	取得下一個父項目屬性。
NodeType	取得此節點的節點類型。
Parent	取得這個 XElement 的 XObject。 (繼承來源 XObject)
PreviousAttribute	取得父項目的前一個屬性。
Value	取得或設定此屬性 (Attribute) 的值。

方法

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 的值轉型為 Nullable<T> 的 Boolean。
Explicit(XAttribute to Nullable<DateTime>)	將此 XAttribute 的值轉型為 Nullable<T> 的 DateTime。
Explicit(XAttribute to Nullable<DateTimeOffset>)	將此 XAttribute 的值轉型為 Nullable<T> 的 DateTimeOffset。
Explicit(XAttribute to Nullable<Decimal>)	將此 XAttribute 的值轉型為 Nullable<T> 的 Decimal。
Explicit(XAttribute to Nullable<Double>)	將此 XAttribute 的值轉型為 Nullable<T> 的 Double。
Explicit(XAttribute to Nullable<Guid>)	將此 XAttribute 的值轉型為 Nullable<T> 的 Guid。
Explicit(XAttribute to Nullable<Int32>)	將此 XAttribute 的值轉型為 Nullable<T> 的 Int32。
Explicit(XAttribute to Nullable<Int64>)	將此 XAttribute 的值轉型為 Nullable<T> 的 Int64。
Explicit(XAttribute to Nullable<Single>)	將此 XAttribute 的值轉型為 Nullable<T> 的 Single。
Explicit(XAttribute to Nullable<TimeSpan>)	將此 XAttribute 的值轉型為 Nullable<T> 的 TimeSpan。
Explicit(XAttribute to Nullable<UInt32>)	將此 XAttribute 的值轉型為 Nullable<T> 的 UInt32。
Explicit(XAttribute to Nullable<UInt64>)	將此 XAttribute 的值轉型為 Nullable<T> 的 UInt64。
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 動態屬性