XmlNode XmlNode XmlNode XmlNode Class

定義

表示 XML 文件中的單一節點。Represents a single node in the XML document.

public ref class XmlNode abstract : ICloneable, System::Collections::IEnumerable, System::Xml::XPath::IXPathNavigable
public abstract class XmlNode : ICloneable, System.Collections.IEnumerable, System.Xml.XPath.IXPathNavigable
type XmlNode = class
    interface ICloneable
    interface IEnumerable
    interface IXPathNavigable
Public MustInherit Class XmlNode
Implements ICloneable, IEnumerable, IXPathNavigable
繼承
XmlNodeXmlNodeXmlNodeXmlNode
衍生
實作

備註

這個類別會實作 W3C 文件物件模型 (DOM) 層級 1 核心及核心 DOM 層級 2。This class implements the W3C Document Object Model (DOM) Level 1 Core and the Core DOM Level 2. DOM 是 XML 文件的記憶體中 (快取) 樹狀結構表示。The DOM is an in-memory (cache) tree representation of an XML document. XmlNode 在 DOM 的.NET 實作的基底類別XmlNode is the base class in the .NET implementation of the DOM. 它支援 XPath 選取項目,並提供編輯功能。It supports XPath selections and provides editing capabilities. XmlDocument類別會擴充XmlNode和代表 XML 文件。The XmlDocument class extends XmlNode and represents an XML document. 您可以使用XmlDocument載入和儲存 XML 資料。You can use XmlDocument to load and save XML data. 它也會包含節點建立方法。It also includes methods for node creation. 請參閱XML 文件物件模型 (DOM)如需詳細資訊。See XML Document Object Model (DOM) for more information.

重要

使用所引發的例外狀況XmlNode類別,例如XmlException類別可能包含不應公開受信任的案例中的機密資訊。Exceptions raised as a result of using the XmlNode class, such as the XmlException class may contain sensitive information that should not be exposed in untrusted scenarios. 使機密資訊不會暴露在不受信任的情況下,就應該正確處理例外狀況。Exceptions should be properly handled so that this sensitive information is not exposed in untrusted scenarios.

屬性

Attributes Attributes Attributes Attributes

取得包含這個節點屬性 (Attribute) 的 XmlAttributeCollectionGets an XmlAttributeCollection containing the attributes of this node.

BaseURI BaseURI BaseURI BaseURI

取得目前節點的基底 (Base) URI。Gets the base URI of the current node.

ChildNodes ChildNodes ChildNodes ChildNodes

取得節點的所有子節點。Gets all the child nodes of the node.

FirstChild FirstChild FirstChild FirstChild

取得節點的第一個子節點。Gets the first child of the node.

HasChildNodes HasChildNodes HasChildNodes HasChildNodes

取得值,指出這個節點是否有子節點。Gets a value indicating whether this node has any child nodes.

InnerText InnerText InnerText InnerText

取得或設定節點和其所有子節點的串連值。Gets or sets the concatenated values of the node and all its child nodes.

InnerXml InnerXml InnerXml InnerXml

取得或設定只表示這個節點之子節點的標記。Gets or sets the markup representing only the child nodes of this node.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

取得值,表示節點是否為唯讀。Gets a value indicating whether the node is read-only.

Item[String, String] Item[String, String] Item[String, String] Item[String, String]

取得具有指定的 LocalNameNamespaceURI 的第一個子項目。Gets the first child element with the specified LocalName and NamespaceURI.

Item[String] Item[String] Item[String] Item[String]

取得具有指定的 Name 的第一個子項目。Gets the first child element with the specified Name.

LastChild LastChild LastChild LastChild

取得節點的最後一個子節點。Gets the last child of the node.

LocalName LocalName LocalName LocalName

在衍生類別中覆寫時,取得節點的區域名稱。Gets the local name of the node, when overridden in a derived class.

Name Name Name Name

在衍生類別中覆寫時,取得節點的限定名稱。Gets the qualified name of the node, when overridden in a derived class.

NamespaceURI NamespaceURI NamespaceURI NamespaceURI

取得這個節點的命名空間 URI。Gets the namespace URI of this node.

NextSibling NextSibling NextSibling NextSibling

取得這個節點的後置節點。Gets the node immediately following this node.

NodeType NodeType NodeType NodeType

在衍生類別中覆寫時,取得目前節點的類型。Gets the type of the current node, when overridden in a derived class.

OuterXml OuterXml OuterXml OuterXml

取得包含這個節點和其所有子節點的標記。Gets the markup containing this node and all its child nodes.

OwnerDocument OwnerDocument OwnerDocument OwnerDocument

取得這個節點所屬的 XmlDocumentGets the XmlDocument to which this node belongs.

ParentNode ParentNode ParentNode ParentNode

取得這個節點的父代 (對於具有父代的節點而言)。Gets the parent of this node (for nodes that can have parents).

Prefix Prefix Prefix Prefix

取得或設定這個節點的命名空間前置詞。Gets or sets the namespace prefix of this node.

PreviousSibling PreviousSibling PreviousSibling PreviousSibling

取得這個節點的前置節點。Gets the node immediately preceding this node.

PreviousText PreviousText PreviousText PreviousText

取得這個節點的前置文字節點。Gets the text node that immediately precedes this node.

SchemaInfo SchemaInfo SchemaInfo SchemaInfo

取得後結構描述驗證資訊集,在結構描述驗證之後已將其指派給這個節點。Gets the post schema validation infoset that has been assigned to this node as a result of schema validation.

Value Value Value Value

取得或設定節點的值。Gets or sets the value of the node.

方法

AppendChild(XmlNode) AppendChild(XmlNode) AppendChild(XmlNode) AppendChild(XmlNode)

將指定的節點加入這個節點之子節點清單的結尾。Adds the specified node to the end of the list of child nodes, of this node.

Clone() Clone() Clone() Clone()

建立這個節點的複本。Creates a duplicate of this node.

CloneNode(Boolean) CloneNode(Boolean) CloneNode(Boolean) CloneNode(Boolean)

在衍生類別中覆寫時,建立節點的複本。Creates a duplicate of the node, when overridden in a derived class.

CreateNavigator() CreateNavigator() CreateNavigator() CreateNavigator()

建立 XPathNavigator 以瀏覽這個物件。Creates an XPathNavigator for navigating this object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

取得逐一查看目前節點中子節點的列舉程式。Gets an enumerator that iterates through the child nodes in the current node.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetNamespaceOfPrefix(String) GetNamespaceOfPrefix(String) GetNamespaceOfPrefix(String) GetNamespaceOfPrefix(String)

查閱目前節點範圍內最接近指定前置詞的 xmlns 宣告,並傳回宣告中的命名空間 URI。Looks up the closest xmlns declaration for the given prefix that is in scope for the current node and returns the namespace URI in the declaration.

GetPrefixOfNamespace(String) GetPrefixOfNamespace(String) GetPrefixOfNamespace(String) GetPrefixOfNamespace(String)

查閱目前節點範圍內最接近指定命名空間 URI 的 xmlns 宣告,並傳回宣告中所定義的前置詞。Looks up the closest xmlns declaration for the given namespace URI that is in scope for the current node and returns the prefix defined in that declaration.

GetType() GetType() GetType() GetType()

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

(Inherited from Object)
InsertAfter(XmlNode, XmlNode) InsertAfter(XmlNode, XmlNode) InsertAfter(XmlNode, XmlNode) InsertAfter(XmlNode, XmlNode)

在指定的參考節點之後,插入指定的節點。Inserts the specified node immediately after the specified reference node.

InsertBefore(XmlNode, XmlNode) InsertBefore(XmlNode, XmlNode) InsertBefore(XmlNode, XmlNode) InsertBefore(XmlNode, XmlNode)

在指定的參考節點之前,插入指定的節點。Inserts the specified node immediately before the specified reference node.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

建立目前 Object 的淺層複製。Creates a shallow copy of the current Object.

(Inherited from Object)
Normalize() Normalize() Normalize() Normalize()

使這個 XmlNode 之下子樹狀結構的整個深度中所有 XmlText 節點成為「一般」形式,其中只用標記 (Markup) (亦即標記 (Tag)、註解、處理指示、CDATA 區段與實體參考) 來分隔 XmlText 節點,也就是說,沒有相鄰的 XmlText 節點。Puts all XmlText nodes in the full depth of the sub-tree underneath this XmlNode into a "normal" form where only markup (that is, tags, comments, processing instructions, CDATA sections, and entity references) separates XmlText nodes, that is, there are no adjacent XmlText nodes.

PrependChild(XmlNode) PrependChild(XmlNode) PrependChild(XmlNode) PrependChild(XmlNode)

將指定的節點加入這個節點之子節點清單的開頭。Adds the specified node to the beginning of the list of child nodes for this node.

RemoveAll() RemoveAll() RemoveAll() RemoveAll()

移除目前節點的所有子節點和/或屬性。Removes all the child nodes and/or attributes of the current node.

RemoveChild(XmlNode) RemoveChild(XmlNode) RemoveChild(XmlNode) RemoveChild(XmlNode)

移除指定的子節點。Removes specified child node.

ReplaceChild(XmlNode, XmlNode) ReplaceChild(XmlNode, XmlNode) ReplaceChild(XmlNode, XmlNode) ReplaceChild(XmlNode, XmlNode)

將子節點 oldChildnewChild 節點取代。Replaces the child node oldChild with newChild node.

SelectNodes(String) SelectNodes(String) SelectNodes(String) SelectNodes(String)

選取符合 XPath 運算式的節點清單。Selects a list of nodes matching the XPath expression.

SelectNodes(String, XmlNamespaceManager) SelectNodes(String, XmlNamespaceManager) SelectNodes(String, XmlNamespaceManager) SelectNodes(String, XmlNamespaceManager)

選取符合 XPath 運算式的節點清單。Selects a list of nodes matching the XPath expression. 使用提供的 XmlNamespaceManager 解析 XPath 運算式中找到的任何前置詞。Any prefixes found in the XPath expression are resolved using the supplied XmlNamespaceManager.

SelectSingleNode(String) SelectSingleNode(String) SelectSingleNode(String) SelectSingleNode(String)

選取符合 XPath 運算式的第一個 XmlNodeSelects the first XmlNode that matches the XPath expression.

SelectSingleNode(String, XmlNamespaceManager) SelectSingleNode(String, XmlNamespaceManager) SelectSingleNode(String, XmlNamespaceManager) SelectSingleNode(String, XmlNamespaceManager)

選取符合 XPath 運算式的第一個 XmlNodeSelects the first XmlNode that matches the XPath expression. 使用提供的 XmlNamespaceManager 解析 XPath 運算式中找到的任何前置詞。Any prefixes found in the XPath expression are resolved using the supplied XmlNamespaceManager.

Supports(String, String) Supports(String, String) Supports(String, String) Supports(String, String)

測試 DOM 實作 (Implementation) 是否實作特定功能。Tests if the DOM implementation implements a specific feature.

ToString() ToString() ToString() ToString()

傳回代表目前物件的字串。Returns a string that represents the current object.

(Inherited from Object)
WriteContentTo(XmlWriter) WriteContentTo(XmlWriter) WriteContentTo(XmlWriter) WriteContentTo(XmlWriter)

在衍生類別中覆寫時,將節點的所有子節點儲存至指定的 XmlWriterSaves all the child nodes of the node to the specified XmlWriter, when overridden in a derived class.

WriteTo(XmlWriter) WriteTo(XmlWriter) WriteTo(XmlWriter) WriteTo(XmlWriter)

在衍生類別中覆寫時,將目前節點儲存至指定的 XmlWriterSaves the current node to the specified XmlWriter, when overridden in a derived class.

明確介面實作

ICloneable.Clone() ICloneable.Clone() ICloneable.Clone() ICloneable.Clone()

如需這個成員的說明,請參閱 Clone()For a description of this member, see Clone().

IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

如需這個成員的說明,請參閱 GetEnumerator()For a description of this member, see GetEnumerator().

Extension Methods

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

IEnumerable 的項目轉換成指定的型別。Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

篩選的項目IEnumerable根據指定的型別。Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

啟用查詢的平行化作業。Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

將轉換IEnumerableIQueryableConverts an IEnumerable to an IQueryable.

CreateNavigator(XmlNode) CreateNavigator(XmlNode) CreateNavigator(XmlNode) CreateNavigator(XmlNode)
SelectNodes(XmlNode, String) SelectNodes(XmlNode, String) SelectNodes(XmlNode, String) SelectNodes(XmlNode, String)
SelectNodes(XmlNode, String, XmlNamespaceManager) SelectNodes(XmlNode, String, XmlNamespaceManager) SelectNodes(XmlNode, String, XmlNamespaceManager) SelectNodes(XmlNode, String, XmlNamespaceManager)
SelectSingleNode(XmlNode, String) SelectSingleNode(XmlNode, String) SelectSingleNode(XmlNode, String) SelectSingleNode(XmlNode, String)
SelectSingleNode(XmlNode, String, XmlNamespaceManager) SelectSingleNode(XmlNode, String, XmlNamespaceManager) SelectSingleNode(XmlNode, String, XmlNamespaceManager) SelectSingleNode(XmlNode, String, XmlNamespaceManager)
ToXPathNavigable(XmlNode) ToXPathNavigable(XmlNode) ToXPathNavigable(XmlNode) ToXPathNavigable(XmlNode)

適用於

另請參閱