XPathNavigator 類別

定義

命名空間:

System.Xml.XPath

組件:

System.Xml.ReaderWriter.dll

Source:

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 類別是抽象類別，它會定義資料指標模型，以巡覽和編輯 XML 資訊專案做為 XQuery 1.0 和 XPath 2.0 資料模型的實例。

物件 XPathNavigator 是從實作 介面的類別建立， IXPathNavigable 例如 XPathDocument 和 XmlDocument 類別。 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

建構函式

XPathNavigator()

初始化 XPathNavigator 類別的新執行個體。

屬性

BaseURI	在衍生類別中覆寫時，取得目前節點的基底 (Base) 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 型別的 Boxed 物件。
UnderlyingObject	由 XPathNavigator 實作所使用，此實作可以提供存放區上的「虛擬化」XML 檢視，或是提供基礎物件的存取。
Value	在衍生類別中覆寫時，取得項目的 string 值。 (繼承來源 XPathItem)
ValueAsBoolean	取得目前的節點值做為 Boolean。
ValueAsDateTime	取得目前的節點值做為 DateTime。
ValueAsDouble	取得目前的節點值做為 Double。
ValueAsInt	取得目前的節點值做為 Int32。
ValueAsLong	取得目前的節點值做為 Int64。
ValueType	取得目前節點的 .NET Type 類型。
XmlLang	xml:lang取得目前節點的範圍。
XmlType	取得目前節點的 XmlSchemaType 資訊。

方法

AppendChild()	傳回 XmlWriter 物件，此物件用來在目前節點的子節點清單結尾建立一或多個新的子節點。
AppendChild(String)	使用指定的 XML 資料字串，在目前節點的子節點清單結尾建立新的子節點。
AppendChild(XmlReader)	使用指定 XmlReader 物件的 XML 內容，在目前節點的子節點清單結尾建立新的子節點。
AppendChild(XPathNavigator)	使用 XPathNavigator 中指定的節點，在目前節點的子節點清單結尾建立新的子節點。
AppendChildElement(String, String, String, String)	使用命名空間前置詞、區域名稱以及有指定值的指定命名空間 URI，在目前節點的子節點清單結尾建立新的子項目節點。
CheckValidity(XmlSchemaSet, ValidationEventHandler)	請驗證 XPathNavigator 中的 XML 資料確實有符合所提供的 XML 結構描述定義語言 (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)	評估指定的 XPath 運算式，並傳回具型別的結果。
Evaluate(String, IXmlNamespaceResolver)	評估指定的 XPath 運算式，並傳回具型別的結果，透過的方式是利用指定的 IXmlNamespaceResolver 物件來解析 XPath 運算式中的命名空間前置詞。
Evaluate(XPathExpression)	評估 XPathExpression，並傳回具型別的結果。
Evaluate(XPathExpression, XPathNodeIterator)	使用提供的內容來評估 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 的子代 (Descendant)。
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 移到具有指定區域名稱和命名空間 URI 的子節點。
MoveToChild(XPathNodeType)	將 XPathNavigator 移到指定 XPathNodeType 的子節點。
MoveToFirst()	將 XPathNavigator 移至目前節點的第一個同層級節點。
MoveToFirstAttribute()	在衍生類別中覆寫時，將 XPathNavigator 移至目前節點的第一個屬性。
MoveToFirstChild()	在衍生類別中覆寫時，將 XPathNavigator 移至目前節點的第一個子節點。
MoveToFirstNamespace()	將 XPathNavigator 移至目前節點的第一個命名空間節點。
MoveToFirstNamespace(XPathNamespaceScope)	在衍生類別中覆寫時，將 XPathNavigator 移至符合指定 XPathNamespaceScope 的第一個命名空間節點。
MoveToFollowing(String, String)	會根據文件順序，將 XPathNavigator 移到具有指定區域名稱和命名空間 URI 的項目。
MoveToFollowing(String, String, XPathNavigator)	會根據文件順序，將 XPathNavigator 移到指定界限之區域名稱和指定命名空間 URI 的項目。
MoveToFollowing(XPathNodeType)	會根據文件順序，將 XPathNavigator 移至下列指定 XPathNodeType 的項目。
MoveToFollowing(XPathNodeType, XPathNavigator)	會根據文件順序，將 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)	使用指定的 XPath 運算式來選取節點集。
Select(String, IXmlNamespaceResolver)	使用指定的 XPath 運算式並搭配用來解析命名空間前置詞的 IXmlNamespaceResolver，以選取節點集。
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)	使用指定的 XPath 查詢，於 XPathNavigator 中選取單一節點。
SelectSingleNode(String, IXmlNamespaceResolver)	使用指定的 XPath 查詢並搭配指定的 XPathNavigator 物件，在 IXmlNamespaceResolver 物件中選取單一節點，以解析命名空間前置詞。
SelectSingleNode(XPathExpression)	使用指定的 XPathNavigator 物件，於 XPathExpression 中選取單一節點。
SetTypedValue(Object)	設定目前節點的類型值。
SetValue(String)	設定目前節點的值。
ToString()	取得目前節點的文字值。
ValueAs(Type)	傳回項目的值，做為指定型別。 (繼承來源 XPathItem)
ValueAs(Type, IXmlNamespaceResolver)	取得目前節點的值做為指定的 Type，透過的方式是使用指定的 IXmlNamespaceResolver 物件來解析命名空間前置詞。
WriteSubtree(XmlWriter)	將目前節點和其子節點的資料流導向指定的 XmlWriter 物件。

明確介面實作

ICloneable.Clone()

建立 XPathNavigator 物件的新複本。

另請參閱

• IXPathNavigable
• XPathDocument
• XmlDocument
• XmlNode
• 使用 XPath 資料模型處理 XML 資料