XNode 類別

定義

命名空間:

System.Xml.Linq

組件:

System.Xml.XDocument.dll

組件:

System.Xml.Linq.dll

組件:

netstandard.dll

表示 XML 樹狀中節點 (元素、註解、文件類型、處理指示或文字節點) 的抽象概念。

C#

public abstract class XNode : System.Xml.Linq.XObject

繼承

Object

XObject

XNode

衍生

System.Xml.Linq.XComment

System.Xml.Linq.XContainer

System.Xml.Linq.XDocumentType

System.Xml.Linq.XProcessingInstruction

System.Xml.Linq.XText

備註

XNode 是下列類型的抽象通用基類：

• XComment

• XContainer

• XDocumentType

• XProcessingInstruction

• XText

XContainer 是下列類型的抽象通用基類：

• XDocument

• XElement

衍生自 XContainer 的類別物件可以包含子節點。

備註

XAttribute不是 XNode 。 屬性會維護為專案上的名稱/值組清單。

如果您要撰寫複雜的 XML 應用程式，例如 XML 編輯器或儲存內容為 XML 的字處理器，您通常會在節點層級工作。 在節點層級工作時的典型活動包括新增節點、刪除節點、轉換節點，以及逐一查看傳回節點集合的座標軸。

屬性

BaseUri	取得此 XObject 的基底 URI。 (繼承來源 XObject)
Document	取得此 XDocument 的 XObject。 (繼承來源 XObject)
DocumentOrderComparer	取得可比較兩個節點相對位置的比較子 (Comparer)。
EqualityComparer	取得可比較兩個節點值是否相等的比較子。
NextNode	取得這個節點的下一個同層級 (Sibling) 節點。
NodeType	取得此 XObject 的節點類型。 (繼承來源 XObject)
Parent	取得這個 XElement 的 XObject。 (繼承來源 XObject)
PreviousNode	取得這個節點的上一個同層級節點。

方法

AddAfterSelf(Object)	將指定的內容加入緊接在此節點後面的位置。
AddAfterSelf(Object[])	將指定的內容加入緊接在此節點後面的位置。
AddAnnotation(Object)	將物件加入此 XObject 的註釋清單。 (繼承來源 XObject)
AddBeforeSelf(Object)	將指定的內容加入緊接在此節點前面的位置。
AddBeforeSelf(Object[])	將指定的內容加入緊接在此節點前面的位置。
Ancestors()	傳回這個節點之上階元素的集合。
Ancestors(XName)	傳回這個節點的上階元素之篩選的集合。 集合中只會包含具有相符之 XName 的項目。
Annotation(Type)	從此 XObject 取得指定類型的第一個註釋物件。 (繼承來源 XObject)
Annotation<T>()	從此 XObject 取得指定類型的第一個註釋物件。 (繼承來源 XObject)
Annotations(Type)	取得此 XObject 之指定類型註釋的集合。 (繼承來源 XObject)
Annotations<T>()	取得此 XObject 之指定類型註釋的集合。 (繼承來源 XObject)
CompareDocumentOrder(XNode, XNode)	比較兩個節點，以確定其相對的 XML 文件順序。
CreateReader()	建立這個節點的 XmlReader。
CreateReader(ReaderOptions)	使用 readerOptions 參數指定的選項建立 XmlReader。
DeepEquals(XNode, XNode)	比較兩個節點的值，包括所有子系節點的值。
ElementsAfterSelf()	依照文件順序，傳回這個節點之後同層級項目的集合。
ElementsAfterSelf(XName)	依照文件順序，傳回這個節點之後同層級項目之篩選的集合。 集合中只會包含具有相符之 XName 的項目。
ElementsBeforeSelf()	依照文件順序，傳回這個節點之前同層級項目的集合。
ElementsBeforeSelf(XName)	依照文件順序，傳回這個節點之前同層級項目之篩選的集合。 集合中只會包含具有相符之 XName 的項目。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsAfter(XNode)	根據文件順序，判斷目前的節點是否出現在指定的節點之後。
IsBefore(XNode)	根據文件順序，判斷目前的節點是否出現在指定的節點之前。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
NodesAfterSelf()	依照文件順序，傳回這個節點之後同層級節點的集合。
NodesBeforeSelf()	依照文件順序，傳回這個節點之前同層級節點的集合。
ReadFrom(XmlReader)	從 XNode 建立 XmlReader。
ReadFromAsync(XmlReader, CancellationToken)	從 XNode 建立 XmlReader。 節點的執行階段類型依讀取器中遇到的第一個節點 NodeType 來決定。
Remove()	將這個節點從其父代 (Parent) 移除。
RemoveAnnotations(Type)	從這個 XObject 中移除指定之類型的註釋。 (繼承來源 XObject)
RemoveAnnotations<T>()	從這個 XObject 中移除指定之類型的註釋。 (繼承來源 XObject)
ReplaceWith(Object)	以指定的內容取代這個節點。
ReplaceWith(Object[])	以指定的內容取代這個節點。
ToString()	針對這個節點傳回縮排的 XML。
ToString(SaveOptions)	傳回這個節點的 XML (可選擇是否停用格式設定)。
WriteTo(XmlWriter)	將這個節點寫入 XmlWriter。
WriteToAsync(XmlWriter, CancellationToken)	將目前的節點寫入 XmlWriter。

事件

Changed	當此 XObject 或其任何子代發生變更時會引發。 (繼承來源 XObject)
Changing	當此 XObject 或其任何子代發生變更時會引發。 (繼承來源 XObject)

明確介面實作

IXmlLineInfo.HasLineInfo()	取得值，指出此 XObject 是否具有行資訊。 (繼承來源 XObject)
IXmlLineInfo.LineNumber	取得基礎 XmlReader 所回報此 XObject 的行號。 (繼承來源 XObject)
IXmlLineInfo.LinePosition	取得基礎 XmlReader 所報告之此 XObject 的行位置。 (繼承來源 XObject)

擴充方法

CreateNavigator(XNode)	建立 XPathNavigator 的 XNode。
CreateNavigator(XNode, XmlNameTable)	建立 XPathNavigator 的 XNode。 XmlNameTable 可讓 XPath 運算式處理時更有效率。
XPathEvaluate(XNode, String)	評估 XPath 運算式。
XPathEvaluate(XNode, String, IXmlNamespaceResolver)	評估 XPath 運算式，並使用指定的 IXmlNamespaceResolver 解析命名空間後置字元。
XPathSelectElement(XNode, String)	使用 XPath 運算式選取 XElement。
XPathSelectElement(XNode, String, IXmlNamespaceResolver)	使用 XPath 運算式選取 XElement，並使用指定的 IXmlNamespaceResolver 解析命名空間後置字元。
XPathSelectElements(XNode, String)	使用 XPath 運算式選取項目的集合。
XPathSelectElements(XNode, String, IXmlNamespaceResolver)	使用 XPath 運算式選取項目集合，並使用指定的 IXmlNamespaceResolver 解析命名空間後置字元。
ToXPathNavigable(XNode)	傳回存取子，讓您巡覽及編輯指定的 XNode。

適用於

另請參閱

• LINQ to XML 概觀