XPathNavigator 類別

定義

命名空間:

System.Xml.XPath

組件:

netstandard.dll, System.Xml.ReaderWriter.dll

來源:

XPathNavigator.cs

提供游標模型用於瀏覽與編輯 XML 資料。

public ref class XPathNavigator abstract : System::Xml::XPath::XPathItem, ICloneable, System::Xml::IXmlNamespaceResolver, System::Xml::XPath::IXPathNavigable

public abstract class XPathNavigator : System.Xml.XPath.XPathItem, ICloneable, System.Xml.IXmlNamespaceResolver, System.Xml.XPath.IXPathNavigable

type XPathNavigator = class
    inherit XPathItem
    interface ICloneable
    interface IXmlNamespaceResolver
    interface IXPathNavigable

Public MustInherit Class XPathNavigator
Inherits XPathItem
Implements ICloneable, IXmlNamespaceResolver, IXPathNavigable

繼承

Object

XPathItem

XPathNavigator

衍生

System.ServiceModel.Dispatcher.SeekableXPathNavigator

實作

ICloneable IXmlNamespaceResolver IXPathNavigable

備註

XPathNavigator命名空間中的System.Xml.XPath類別是一個抽象類別，定義了一個游標模型，用於作為 XQuery 1.0 和 XPath 2.0 資料模型的實例，來導航和編輯 XML 資訊項目。

XPathNavigator物件是由實IXPathNavigable作介面的類別（如 和 XPathDocumentXmlDocument 類別）所建立。 XPathNavigator 由 XPathDocument 物件建立的物件為唯讀，而 XPathNavigator 由 XmlDocument 物件建立的物件則可編輯。 XPathNavigator物件的唯讀或可編輯狀態是透過CanEdit類別的XPathNavigator屬性來決定的。

欲了解更多使用 XPath 資料模型處理 XML 資料的資訊，請參閱「 利用 XPath 資料模型處理 XML 資料 」主題。

這很重要

使用該 XPathNavigator 類別而產生的例外，例如該 XPathException 類別，可能包含不應在不可信情境下暴露的敏感資訊。 應正確處理例外狀況，如此一來，此敏感性資訊就不會在不受信任的案例中公開。

給實施者的注意事項

當你從該類別繼 XPathNavigator 承時，必須覆蓋以下成員：

• NameTable

• Clone()

• NodeType

• LocalName

• Name

• NamespaceURI

• Prefix

• BaseURI

• IsEmptyElement

• MoveToFirstAttribute()

• MoveToNextAttribute()

• MoveToFirstNamespace(XPathNamespaceScope)

• MoveToNextNamespace(XPathNamespaceScope)

• MoveToNext()

• MoveToPrevious()

• MoveToFirstChild()

• MoveToParent()

• MoveTo(XPathNavigator)

• MoveToId(String)

• IsSamePosition(XPathNavigator)

• Value

建構函式

名稱	Description
XPathNavigator()	初始化 XPathNavigator 類別的新執行個體。

屬性

名稱	Description
BaseURI	當在派生類別中被覆寫時，會取得目前節點的基礎 URI。
CanEdit	會取得一個值，表示是否 XPathNavigator 能編輯底層的 XML 資料。
HasAttributes	會得到一個值，表示目前節點是否有任何屬性。
HasChildren	會得到一個值，表示目前節點是否有子節點。
InnerXml	取得或設定標記，代表當前節點的子節點。
IsEmptyElement	當在衍生類別中覆寫時，會得到一個值，表示目前節點是否為沒有終點元素標籤的空元素。
IsNode	會得到一個值，表示目前節點是否代表 XPath 節點。
LocalName	當在衍生類別中被覆寫時，會得到目前節點的 ， Name 且不帶任何命名空間前綴。
Name	當在衍生類別中覆寫時，會獲得當前節點的限定名稱。
NamespaceURI	當在派生類別中被覆寫時，會取得目前節點的命名空間 URI。
NameTable	當在導出類別中覆寫時，得到 XmlNameTable 的 XPathNavigator。
NavigatorComparer	被 IEqualityComparer 用於物件的等式比較 XPathNavigator 。
NodeType	當在派生類別中覆寫時，會得到目前節點的 。XPathNodeType
OuterXml	取得或設定標記，代表當前節點及其子節點的開啟與關閉標籤。
Prefix	當在衍生類別中被覆寫時，會獲得與當前節點相關的命名空間前綴。
SchemaInfo	取得因結構驗證而指派給當前節點的結構資訊。
TypedValue	取得目前節點作為最合適的 .NET 型別的盒裝物件。
UnderlyingObject	XPathNavigator用於提供「虛擬化」XML 視圖的實作，透過儲存，提供對底層物件的存取。
Value	當在衍生類別中被覆寫時，會得到 string 該項目的值。 (繼承來源 XPathItem)
ValueAsBoolean	取得當前節點的值為 Boolean。
ValueAsDateTime	取得當前節點的值為 DateTime。
ValueAsDouble	取得當前節點的值為 Double。
ValueAsInt	取得當前節點的值為 Int32。
ValueAsLong	取得當前節點的值為 Int64。
ValueType	取得目前節點的 .NET Type 檔。
XmlLang	取得 xml:lang 目前節點的範圍。
XmlType	取得 XmlSchemaType 目前節點的資訊。

方法

名稱	Description
AppendChild()	回傳 XmlWriter 一個物件，用於在當前節點子節點清單的末尾建立一個或多個新的子節點。
AppendChild(String)	利用指定的 XML 資料字串，在目前節點子節點清單的末尾建立一個新的子節點。
AppendChild(XmlReader)	利用指定物件的 XmlReader XML 內容，在當前節點子節點清單的末尾建立一個新的子節點。
AppendChild(XPathNavigator)	在當前節點的子節點清單末尾建立一個新的子節點，使用指定的節點 XPathNavigator 。
AppendChildElement(String, String, String, String)	在當前節點子節點清單的末尾建立一個新的子元素節點，使用命名空間前綴、本地名稱及指定值的命名空間 URI。
CheckValidity(XmlSchemaSet, ValidationEventHandler)	驗證 XML 資料 XPathNavigator 是否符合所提供的 XML Schema 定義語言（XSD）架構。
Clone()	當在派生類別中被覆寫時，會建立 XPathNavigator 一個位於與此 XPathNavigator相同的節點的新節點。
ComparePosition(XPathNavigator)	比較電流 XPathNavigator 的位置與指定位置 XPathNavigator 。
Compile(String)	編譯代表 XPath 運算式的字串並回傳物件 XPathExpression 。
CreateAttribute(String, String, String, String)	在當前元素節點上建立屬性節點，使用命名空間前綴、本地名稱及指定命名空間 URI，並指定值。
CreateAttributes()	回傳 XmlWriter 一個用於在當前元素上建立新屬性的物件。
CreateNavigator()	回傳一份 XPathNavigator.
DeleteRange(XPathNavigator)	從目前節點刪除一組兄弟節點到指定的節點。
DeleteSelf()	刪除目前的節點及其子節點。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
Evaluate(String, IXmlNamespaceResolver)	評估指定的 XPath 表達式並回傳型別結果，使用 IXmlNamespaceResolver 指定的物件來解析 XPath 表達式中的命名空間前綴。
Evaluate(String)	評估指定的 XPath 表達式並回傳型別結果。
Evaluate(XPathExpression, XPathNodeIterator)	利用提供的上下文來評估 XPathExpression，並回傳打型結果。
Evaluate(XPathExpression)	評估 並 XPathExpression 回傳打字結果。
GetAttribute(String, String)	取得具有指定本地名稱與命名空間 URI 的屬性值。
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetNamespace(String)	回傳對應指定本地名稱的命名空間節點值。
GetNamespacesInScope(XmlNamespaceScope)	回傳目前節點的範圍內命名空間。
GetType()	取得目前實例的 Type。 (繼承來源 Object)
InsertAfter()	回傳 XmlWriter 一個物件，用於在目前選取節點之後建立新的兄弟節點。
InsertAfter(String)	在目前選擇的節點之後，使用指定的 XML 字串建立新的兄弟節點。
InsertAfter(XmlReader)	利用指定物件的 XmlReader XML 內容，在目前選擇的節點之後建立新的兄弟節點。
InsertAfter(XPathNavigator)	在目前選擇的節點之後，使用指定物件中的 XPathNavigator 節點建立一個新的兄弟節點。
InsertBefore()	回傳 XmlWriter 一個物件，用於在目前選擇的節點之前建立新的兄弟節點。
InsertBefore(String)	利用指定的 XML 字串，在目前選擇的節點前建立一個新的兄弟節點。
InsertBefore(XmlReader)	利用指定物件的 XmlReader XML 內容，在目前選擇的節點前建立一個新的兄弟節點。
InsertBefore(XPathNavigator)	在目前選擇的節點之前，使用指定的節點 XPathNavigator 建立一個新的兄弟節點。
InsertElementAfter(String, String, String, String)	在當前節點後建立新的兄弟元素，使用命名空間前綴、本地名稱及指定命名空間 URI，並指定值。
InsertElementBefore(String, String, String, String)	在當前節點前建立一個新的兄弟元素，使用命名空間前綴、本地名稱及指定命名空間 URI，並指定值。
IsDescendant(XPathNavigator)	判斷指定 XPathNavigator 是否為當前流 XPathNavigator的後代。
IsSamePosition(XPathNavigator)	當在導出類別中覆寫時，判斷電流是否 XPathNavigator 與指定的 XPathNavigator位置相同。
LookupNamespace(String)	取得指定前綴的命名空間 URI。
LookupPrefix(String)	取得指定命名空間 URI 的前綴宣告。
Matches(String)	判斷目前節點是否符合指定的 XPath 表達式。
Matches(XPathExpression)	判斷目前節點是否符合指定的 XPathExpression。
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
MoveTo(XPathNavigator)	當在導出類別中被覆寫時，會將 移動 XPathNavigator 到 與指定 XPathNavigator相同的位置。
MoveToAttribute(String, String)	將 移 XPathNavigator 至 具有匹配本地名稱與命名空間 URI 的屬性。
MoveToChild(String, String)	將 移 XPathNavigator 至 Network 的子節點，並指定本地名稱與命名空間 URI。
MoveToChild(XPathNodeType)	將 移動 XPathNavigator 到 指定的子節點 XPathNodeType 。
MoveToFirst()	將XPathNavigator移動到目前節點的第一個同層級節點。
MoveToFirstAttribute()	當在衍生類別中覆寫時，會將 移 XPathNavigator 至 目前節點的第一個屬性。
MoveToFirstChild()	當在衍生類別中覆寫時，會將 移 XPathNavigator 至 目前節點的第一個子節點。
MoveToFirstNamespace()	將 移動 XPathNavigator 到目前節點的第一個命名空間節點。
MoveToFirstNamespace(XPathNamespaceScope)	當在派生類別中覆寫時，會將 移 XPathNavigator 至 第一個與指定節點相符 XPathNamespaceScope 的命名空間節點。
MoveToFollowing(String, String, XPathNavigator)	將 移動 XPathNavigator 到指定本地名稱與命名空間 URI 的元素，並依文件順序移動至指定邊界。
MoveToFollowing(String, String)	將 移動 XPathNavigator 到以文件順序指定的本地名稱與命名空間 URI 的元素。
MoveToFollowing(XPathNodeType, XPathNavigator)	將 移動 XPathNavigator 到指定元素的下一個元素 XPathNodeType ，按文件順序移動到指定邊界。
MoveToFollowing(XPathNodeType)	將 移動 XPathNavigator 到文件中指定的下一個元素 XPathNodeType 。
MoveToId(String)	當在衍生類別中覆寫時，會移動到具有屬性 的 ID 節點，該屬性值與指定的 String相符。
MoveToNamespace(String)	將 移動 XPathNavigator 到指定命名空間前綴的命名空間節點。
MoveToNext()	當在衍生類別中被覆寫時，會將 移 XPathNavigator 至 目前節點的下一個兄弟節點。
MoveToNext(String, String)	將 移動 XPathNavigator 到指定本地名稱與命名空間 URI 的下一個兄弟節點。
MoveToNext(XPathNodeType)	將 移動 XPathNavigator 到目前節點下一個與指定節點相符 XPathNodeType 的兄弟節點。
MoveToNextAttribute()	當在衍生類別中覆寫時，將 移 XPathNavigator 至下一個屬性。
MoveToNextNamespace()	將 移 XPathNavigator 到 下一個命名空間節點。
MoveToNextNamespace(XPathNamespaceScope)	當在派生類別中被覆寫時，會將 移動 XPathNavigator 到下一個符合 XPathNamespaceScope 指定命名的命名空間節點。
MoveToParent()	當在衍生類別中覆寫時，會將 移動 XPathNavigator 到當前節點的父節點。
MoveToPrevious()	當在衍生類別中被覆寫時，會將 移動 XPathNavigator 到 目前節點的前一個兄弟節點。
MoveToRoot()	將 移 XPathNavigator 到 目前節點所屬的根節點。
PrependChild()	回傳 XmlWriter 一個用於在當前節點子節點清單開頭建立新子節點的物件。
PrependChild(String)	在當前節點子節點清單的開頭建立一個新的子節點，使用指定的 XML 字串。
PrependChild(XmlReader)	利用指定物件的 XmlReader XML 內容，在當前節點子節點清單的開頭建立一個新的子節點。
PrependChild(XPathNavigator)	在當前節點子節點清單的開頭，使用指定物件中的 XPathNavigator 節點建立一個新的子節點。
PrependChildElement(String, String, String, String)	在當前節點子節點清單的開頭建立一個新的子元素，使用命名空間前綴、本地名稱及指定命名空間 URI，並指定值。
ReadSubtree()	回傳 XmlReader 包含當前節點及其子節點的物件。
ReplaceRange(XPathNavigator)	替換從目前節點到指定節點的一系列兄弟節點。
ReplaceSelf(String)	以指定字串內容替換當前節點。
ReplaceSelf(XmlReader)	將當前節點替換為指定物件的內容 XmlReader 。
ReplaceSelf(XPathNavigator)	將當前節點替換為指定物件的內容 XPathNavigator 。
Select(String, IXmlNamespaceResolver)	使用指定的 XPath 表達式選擇節點集合，並 IXmlNamespaceResolver 指定物件以解析命名空間前綴。
Select(String)	使用指定的 XPath 表達式選擇節點集合。
Select(XPathExpression)	利用指定的 XPathExpression節點集合選擇。
SelectAncestors(String, String, Boolean)	選擇目前節點所有具有指定本地名稱與命名空間 URI 的祖先節點。
SelectAncestors(XPathNodeType, Boolean)	選取目前節點所有具有匹配 XPathNodeType的祖先節點。
SelectChildren(String, String)	選取目前節點所有指定本地名稱與命名空間 URI 的子節點。
SelectChildren(XPathNodeType)	選擇目前節點中所有與 相符 XPathNodeType的子節點。
SelectDescendants(String, String, Boolean)	選擇目前節點的所有後代節點，並指定本地名稱與命名空間 URI。
SelectDescendants(XPathNodeType, Boolean)	選擇所有與 相符 XPathNodeType的當前節點的後代節點。
SelectSingleNode(String, IXmlNamespaceResolver)	使用指定的 XPath 查詢選擇物件中的 XPathNavigator 單一節點，並 IXmlNamespaceResolver 指定該物件以解析命名空間前綴。
SelectSingleNode(String)	利用指定的 XPath 查詢選擇 中的 XPathNavigator 單一節點。
SelectSingleNode(XPathExpression)	使用指定的XPathExpression物件選擇 中的XPathNavigator單一節點。
SetTypedValue(Object)	設定目前節點的型別值。
SetValue(String)	設定目前節點的值。
ToString()	取得當前節點的文字值。
ValueAs(Type, IXmlNamespaceResolver)	取得當前節點的值， Type 作為指定的，並利用 IXmlNamespaceResolver 指定的物件解析命名空間前綴。
ValueAs(Type)	回傳該項目的值，並符合指定的類型。 (繼承來源 XPathItem)
WriteSubtree(XmlWriter)	將目前的節點及其子節點串流到 XmlWriter 指定的物件。

明確介面實作

名稱	Description
ICloneable.Clone()	建立一個新的物件副本 XPathNavigator 。

另請參閱

• IXPathNavigable
• XPathDocument
• XmlDocument
• XmlNode
• 使用 XPath 數據模型處理 XML 數據