XNode 類別

定義

表示 XML 樹狀結構中節點 (項目、註解、文件類型、處理指示或文字節點) 的抽象概念。Represents the abstract concept of a node (element, comment, document type, processing instruction, or text node) in the XML tree.

public ref class XNode abstract : System::Xml::Linq::XObject
public abstract class XNode : System.Xml.Linq.XObject
type XNode = class
    inherit XObject
Public MustInherit Class XNode
Inherits XObject
繼承
XNode
衍生

備註

XNode是下列類型的抽象一般基類:XNode is an abstract common base class for the following types:

XContainer是下列類型的抽象一般基類:XContainer is an abstract common base class for the following types:

衍生自之XContainer類別的物件可以包含子節點。Objects of classes that derive from XContainer can contain child nodes.

注意

XAttributeXNodeAn XAttribute is not an XNode. 屬性會以名稱/值組的清單的形式保留在元素上。Attributes are maintained as a list of name/value pairs on an element.

如果您撰寫的是複雜的 XML 應用程式,例如 XML 編輯器或將內容儲存為 XML 的文字處理器,您通常會在節點層級上工作。If you are writing a complex XML application, such as an XML editor or a word processor that stores content as XML, you will often work at the node level. 在節點層級工作時的典型活動包括加入節點、刪除節點、轉換節點,以及逐一查看傳回節點集合的座標軸。Typical activities when working at the node level include adding nodes, deleting nodes, transforming nodes, and iterating through axes that return collections of nodes.

屬性

BaseUri

取得此 XObject 的基底 URI。Gets the base URI for this XObject.

(繼承來源 XObject)
Document

取得此 XDocumentXObjectGets the XDocument for this XObject.

(繼承來源 XObject)
DocumentOrderComparer

取得可比較兩個節點相對位置的比較子 (Comparer)。Gets a comparer that can compare the relative position of two nodes.

EqualityComparer

取得可比較兩個節點值是否相等的比較子。Gets a comparer that can compare two nodes for value equality.

NextNode

取得這個節點的下一個同層級 (Sibling) 節點。Gets the next sibling node of this node.

NodeType

取得此 XObject 的節點類型。Gets the node type for this XObject.

(繼承來源 XObject)
Parent

取得這個 XElementXObjectGets the parent XElement of this XObject.

(繼承來源 XObject)
PreviousNode

取得這個節點的上一個同層級節點。Gets the previous sibling node of this node.

方法

AddAfterSelf(Object)

將指定的內容加入緊接在此節點後面的位置。Adds the specified content immediately after this node.

AddAfterSelf(Object[])

將指定的內容加入緊接在此節點後面的位置。Adds the specified content immediately after this node.

AddAnnotation(Object)

將物件加入此 XObject 的註釋清單。Adds an object to the annotation list of this XObject.

(繼承來源 XObject)
AddBeforeSelf(Object)

將指定的內容加入緊接在此節點前面的位置。Adds the specified content immediately before this node.

AddBeforeSelf(Object[])

將指定的內容加入緊接在此節點前面的位置。Adds the specified content immediately before this node.

Ancestors()

傳回這個節點之祖系項目的集合。Returns a collection of the ancestor elements of this node.

Ancestors(XName)

傳回這個節點的祖系項目之篩選的集合。Returns a filtered collection of the ancestor elements of this node. 集合中只會包含具有相符之 XName 的項目。Only elements that have a matching XName are included in the collection.

Annotation(Type)

從此 XObject 取得指定類型的第一個註釋物件。Gets the first annotation object of the specified type from this XObject.

(繼承來源 XObject)
Annotation<T>()

從此 XObject 取得指定類型的第一個註釋物件。Gets the first annotation object of the specified type from this XObject.

(繼承來源 XObject)
Annotations(Type)

取得此 XObject 之指定類型註釋的集合。Gets a collection of annotations of the specified type for this XObject.

(繼承來源 XObject)
Annotations<T>()

取得此 XObject 之指定類型註釋的集合。Gets a collection of annotations of the specified type for this XObject.

(繼承來源 XObject)
CompareDocumentOrder(XNode, XNode)

比較兩個節點,以確定其相對的 XML 文件順序。Compares two nodes to determine their relative XML document order.

CreateReader()

建立這個節點的 XmlReaderCreates an XmlReader for this node.

CreateReader(ReaderOptions)

使用 readerOptions 參數指定的選項建立 XmlReaderCreates an XmlReader with the options specified by the readerOptions parameter.

DeepEquals(XNode, XNode)

比較兩個節點的值,包括所有子代節點的值。Compares the values of two nodes, including the values of all descendant nodes.

ElementsAfterSelf()

依照文件順序,傳回這個節點之後同層級項目的集合。Returns a collection of the sibling elements after this node, in document order.

ElementsAfterSelf(XName)

依照文件順序,傳回這個節點之後同層級項目之篩選的集合。Returns a filtered collection of the sibling elements after this node, in document order. 集合中只會包含具有相符之 XName 的項目。Only elements that have a matching XName are included in the collection.

ElementsBeforeSelf()

依照文件順序,傳回這個節點之前同層級項目的集合。Returns a collection of the sibling elements before this node, in document order.

ElementsBeforeSelf(XName)

依照文件順序,傳回這個節點之前同層級項目之篩選的集合。Returns a filtered collection of the sibling elements before this node, in document order. 集合中只會包含具有相符之 XName 的項目。Only elements that have a matching XName are included in the collection.

Equals(Object)

判斷指定的物件是否等於目前的物件。Determines whether the specified object is equal to the current object.

(繼承來源 Object)
GetHashCode()

做為預設雜湊函式。Serves as the default hash function.

(繼承來源 Object)
GetType()

取得目前執行個體的 TypeGets the Type of the current instance.

(繼承來源 Object)
IsAfter(XNode)

根據文件順序,判斷目前的節點是否出現在指定的節點之後。Determines if the current node appears after a specified node in terms of document order.

IsBefore(XNode)

根據文件順序,判斷目前的節點是否出現在指定的節點之前。Determines if the current node appears before a specified node in terms of document order.

MemberwiseClone()

建立目前 Object 的淺層複本 (Shallow Copy)。Creates a shallow copy of the current Object.

(繼承來源 Object)
NodesAfterSelf()

依照文件順序,傳回這個節點之後同層級節點的集合。Returns a collection of the sibling nodes after this node, in document order.

NodesBeforeSelf()

依照文件順序,傳回這個節點之前同層級節點的集合。Returns a collection of the sibling nodes before this node, in document order.

ReadFrom(XmlReader)

XNode 建立 XmlReaderCreates an XNode from an XmlReader.

ReadFromAsync(XmlReader, CancellationToken)

XNode 建立 XmlReaderCreates an XNode from an XmlReader. 節點的執行階段類型依讀取器中遇到的第一個節點 NodeType 來決定。The runtime type of the node is determined by the NodeType of the first node encountered in the reader.

Remove()

將這個節點從其父代 (Parent) 移除。Removes this node from its parent.

RemoveAnnotations(Type)

從這個 XObject 中移除指定之類型的註釋。Removes the annotations of the specified type from this XObject.

(繼承來源 XObject)
RemoveAnnotations<T>()

從這個 XObject 中移除指定之類型的註釋。Removes the annotations of the specified type from this XObject.

(繼承來源 XObject)
ReplaceWith(Object)

以指定的內容取代這個節點。Replaces this node with the specified content.

ReplaceWith(Object[])

以指定的內容取代這個節點。Replaces this node with the specified content.

ToString()

針對這個節點傳回縮排的 XML。Returns the indented XML for this node.

ToString(SaveOptions)

傳回這個節點的 XML (可選擇是否停用格式設定)。Returns the XML for this node, optionally disabling formatting.

WriteTo(XmlWriter)

將這個節點寫入 XmlWriterWrites this node to an XmlWriter.

WriteToAsync(XmlWriter, CancellationToken)

將目前的節點寫入 XmlWriterWrites the current node to an XmlWriter.

事件

Changed

當此 XObject 或其任何子代發生變更時會引發。Raised when this XObject or any of its descendants have changed.

(繼承來源 XObject)
Changing

當此 XObject 或其任何子代發生變更時會引發。Raised when this XObject or any of its descendants are about to change.

(繼承來源 XObject)

明確介面實作

IXmlLineInfo.HasLineInfo()

取得值,指出此 XObject 是否具有行資訊。Gets a value indicating whether or not this XObject has line information.

(繼承來源 XObject)
IXmlLineInfo.LineNumber

取得基礎 XmlReader 所回報此 XObject 的行號。Gets the line number that the underlying XmlReader reported for this XObject.

(繼承來源 XObject)
IXmlLineInfo.LinePosition

取得基礎 XmlReader 所報告之此 XObject 的行位置。Gets the line position that the underlying XmlReader reported for this XObject.

(繼承來源 XObject)

擴充方法

CreateNavigator(XNode)

建立 XPathNavigatorXNodeCreates an XPathNavigator for an XNode.

CreateNavigator(XNode, XmlNameTable)

建立 XPathNavigatorXNodeCreates an XPathNavigator for an XNode. XmlNameTable 可讓 XPath 運算式處理時更有效率。The XmlNameTable enables more efficient XPath expression processing.

XPathEvaluate(XNode, String)

評估 XPath 運算式。Evaluates an XPath expression.

XPathEvaluate(XNode, String, IXmlNamespaceResolver)

評估 XPath 運算式,並使用指定的 IXmlNamespaceResolver 解析命名空間後置字元。Evaluates an XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver.

XPathSelectElement(XNode, String)

使用 XPath 運算式選取 XElementSelects an XElement using a XPath expression.

XPathSelectElement(XNode, String, IXmlNamespaceResolver)

使用 XPath 運算式選取 XElement,並使用指定的 IXmlNamespaceResolver 解析命名空間後置字元。Selects an XElement using a XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver.

XPathSelectElements(XNode, String)

使用 XPath 運算式選取項目的集合。Selects a collection of elements using an XPath expression.

XPathSelectElements(XNode, String, IXmlNamespaceResolver)

使用 XPath 運算式選取項目集合,並使用指定的 IXmlNamespaceResolver 解析命名空間後置字元。Selects a collection of elements using an XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver.

ToXPathNavigable(XNode)

傳回存取子,讓您巡覽及編輯指定的 XNodeReturns an accessor that allows you to navigate and edit the specified XNode.

適用於

另請參閱