SeekableXPathNavigator 類別

定義

命名空間:

System.ServiceModel.Dispatcher

組件:

System.ServiceModel.dll

提供對 XML 文件所包含資料的唯讀隨機存取，並讓您可以對指定的節點進行有效率的查詢。

public ref class SeekableXPathNavigator abstract : System::Xml::XPath::XPathNavigator

public abstract class SeekableXPathNavigator : System.Xml.XPath.XPathNavigator

type SeekableXPathNavigator = class
    inherit XPathNavigator

Public MustInherit Class SeekableXPathNavigator
Inherits XPathNavigator

繼承

Object

XPathItem

XPathNavigator

SeekableXPathNavigator

備註

在 Windows Communication Foundation (WCF) 系統的各個元件之間傳遞的 SOAP 訊息是由系統的各個元件處理，這些元件必須檢查這些訊息，以判斷處理這些訊息時要採取的動作。 XPath 引擎就是據此目的而負責查詢訊息的元件，而您需要使用導覽才能讀取 SOAP 訊息和其他 XML 文件。 導覽會提供游標，這個游標會從節點移動至節點，並追蹤 XML 文件實際被讀取的位置。

XPath 引擎會使用 SeekableXPathNavigator，這個類別會加入 XPathNavigator 屬性來擴充 CurrentPosition 類別。 這個屬性允許儲存 XML 文件中的位置並迅速將其載入，而不需要複製 (Clone) 導覽；此類作業對 XPathNavigator 而言，是非常耗費資源的記憶體配置。 為了讓 SeekableXPathNavigator 針對訊息處理提供重要的最佳化效果，XPath 引擎必須經常記錄游標在 XML 文件查詢執行過程中的位置。

請注意，CurrentPosition 屬性的值是特定實作專用的，因此不會對應至節點位置或字元位置。 它只對提供此值的 SeekableXPathNavigator 實作 (和執行個體) 具有意義。

建構函式

SeekableXPathNavigator()

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

屬性

BaseURI	在衍生類別中覆寫時，取得目前節點的基底 (Base) URI。 (繼承來源 XPathNavigator)
CanEdit	取得值，指出 XPathNavigator 是否可以編輯底層 XML 資料。 (繼承來源 XPathNavigator)
CurrentPosition	在衍生類別中覆寫時，取得或設定與節點相關聯的值，而此節點位於 XPath 導覽所在位置的資料中。
HasAttributes	取得值，指出目前節點是否具有任何屬性。 (繼承來源 XPathNavigator)
HasChildren	取得值，指出目前節點是否具有任何子節點。 (繼承來源 XPathNavigator)
InnerXml	取得或設定表示目前節點之子節點的標記。 (繼承來源 XPathNavigator)
IsEmptyElement	在衍生類別中覆寫時，取得值，指出目前的節點是否為空元素，且沒有結尾元素標記。 (繼承來源 XPathNavigator)
IsNode	取得值，指出目前的節點是否表示 XPath 節點。 (繼承來源 XPathNavigator)
LocalName	在衍生類別中覆寫時，取得目前節點的 Name，而不含任何命名空間前置詞。 (繼承來源 XPathNavigator)
Name	在衍生類別中覆寫時，取得目前節點的限定名稱。 (繼承來源 XPathNavigator)
NamespaceURI	在衍生類別中覆寫時，取得目前節點的命名空間 URI。 (繼承來源 XPathNavigator)
NameTable	在衍生類別中覆寫時，取得 XmlNameTable 的 XPathNavigator。 (繼承來源 XPathNavigator)
NodeType	在衍生類別中覆寫時，取得目前節點的 XPathNodeType。 (繼承來源 XPathNavigator)
OuterXml	取得或設定標記，表示目前節點和其子節點的開頭和結尾標記。 (繼承來源 XPathNavigator)
Prefix	在衍生類別中覆寫時，取得與目前節點相關的命名空間前置詞。 (繼承來源 XPathNavigator)
SchemaInfo	取得在結構描述驗證之後已指派給目前節點的結構描述資訊。 (繼承來源 XPathNavigator)
TypedValue	取得目前的節點，作為最適當的 .NET 型別的 Boxed 物件。 (繼承來源 XPathNavigator)
UnderlyingObject	由 XPathNavigator 實作所使用，此實作可以提供存放區上的「虛擬化」XML 檢視，或是提供基礎物件的存取。 (繼承來源 XPathNavigator)
Value	在衍生類別中遭到覆寫時，取得該項目的字串值。 (繼承來源 XPathNavigator)
ValueAsBoolean	取得目前的節點值做為 Boolean。 (繼承來源 XPathNavigator)
ValueAsDateTime	取得目前的節點值做為 DateTime。 (繼承來源 XPathNavigator)
ValueAsDouble	取得目前的節點值做為 Double。 (繼承來源 XPathNavigator)
ValueAsInt	取得目前的節點值做為 Int32。 (繼承來源 XPathNavigator)
ValueAsLong	取得目前的節點值做為 Int64。 (繼承來源 XPathNavigator)
ValueType	取得目前節點的 .NET Type 類型。 (繼承來源 XPathNavigator)
XmlLang	xml:lang取得目前節點的範圍。 (繼承來源 XPathNavigator)
XmlType	取得目前節點的 XmlSchemaType 資訊。 (繼承來源 XPathNavigator)

方法

AppendChild()	傳回 XmlWriter 物件，此物件用來在目前節點的子節點清單結尾建立一或多個新的子節點。 (繼承來源 XPathNavigator)
AppendChild(String)	使用指定的 XML 資料字串，在目前節點的子節點清單結尾建立新的子節點。 (繼承來源 XPathNavigator)
AppendChild(XmlReader)	使用指定 XmlReader 物件的 XML 內容，在目前節點的子節點清單結尾建立新的子節點。 (繼承來源 XPathNavigator)
AppendChild(XPathNavigator)	使用 XPathNavigator 中指定的節點，在目前節點的子節點清單結尾建立新的子節點。 (繼承來源 XPathNavigator)
AppendChildElement(String, String, String, String)	使用命名空間前置詞、區域名稱以及有指定值的指定命名空間 URI，在目前節點的子節點清單結尾建立新的子項目節點。 (繼承來源 XPathNavigator)
CheckValidity(XmlSchemaSet, ValidationEventHandler)	請驗證 XPathNavigator 中的 XML 資料確實有符合所提供的 XML 結構描述定義語言 (XSD) 結構描述。 (繼承來源 XPathNavigator)
Clone()	在衍生類別中覆寫時，請在與此 XPathNavigator 相同的節點上建立新的 XPathNavigator。 (繼承來源 XPathNavigator)
ComparePosition(Int64, Int64)	在衍生類別中覆寫時，傳回一個值來描述兩個已指定位置的文件順序。
ComparePosition(XPathNavigator)	比較目前 XPathNavigator 的位置與指定 XPathNavigator 的位置。 (繼承來源 XPathNavigator)
Compile(String)	編譯表示 XPath 運算式的字串，並傳回 XPathExpression 物件。 (繼承來源 XPathNavigator)
CreateAttribute(String, String, String, String)	使用命名空間前置詞、區域名稱以及有指定值的指定命名空間 URI，在目前的項目節點上建立屬性節點。 (繼承來源 XPathNavigator)
CreateAttributes()	傳回 XmlWriter 物件，此物件是用來在目前的項目上建立新的屬性。 (繼承來源 XPathNavigator)
CreateNavigator()	傳回 XPathNavigator 的複本。 (繼承來源 XPathNavigator)
DeleteRange(XPathNavigator)	刪除從目前節點到指定節點的某範圍之同層級節點。 (繼承來源 XPathNavigator)
DeleteSelf()	刪除目前的節點和它的子節點。 (繼承來源 XPathNavigator)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
Evaluate(String)	評估指定的 XPath 運算式，並傳回具型別的結果。 (繼承來源 XPathNavigator)
Evaluate(String, IXmlNamespaceResolver)	評估指定的 XPath 運算式，並傳回具型別的結果，透過的方式是利用指定的 IXmlNamespaceResolver 物件來解析 XPath 運算式中的命名空間前置詞。 (繼承來源 XPathNavigator)
Evaluate(XPathExpression)	評估 XPathExpression，並傳回具型別的結果。 (繼承來源 XPathNavigator)
Evaluate(XPathExpression, XPathNodeIterator)	使用提供的內容來評估 XPathExpression，並傳回具型別的結果。 (繼承來源 XPathNavigator)
GetAttribute(String, String)	取得具有指定的區域名稱和命名空間 URI 的屬性值。 (繼承來源 XPathNavigator)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetLocalName(Int64)	在衍生類別中覆寫時，傳回位於已指定位置之節點的本機名稱。
GetName(Int64)	在衍生類別中覆寫時，傳回位於已指定位置之節點的名稱。
GetNamespace(Int64)	在衍生類別中覆寫時，傳回位於已指定位置之節點的命名空間。
GetNamespace(String)	傳回對應至指定區域名稱之命名空間節點的值。 (繼承來源 XPathNavigator)
GetNamespacesInScope(XmlNamespaceScope)	傳回目前節點範圍中的命名空間。 (繼承來源 XPathNavigator)
GetNodeType(Int64)	在衍生類別中覆寫時，傳回位於已指定位置之節點的類型。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
GetValue(Int64)	在衍生類別中覆寫時，傳回位於已指定位置之節點的文字值。
InsertAfter()	傳回 XmlWriter 物件，此物件用來在目前選取的節點之後建立新的同層級節點。 (繼承來源 XPathNavigator)
InsertAfter(String)	使用指定的 XML 字串，在目前選取的節點之後建立新的同層級節點。 (繼承來源 XPathNavigator)
InsertAfter(XmlReader)	使用指定之 XmlReader 物件的 XML 內容，在目前選取的節點之後建立新的同層級節點。 (繼承來源 XPathNavigator)
InsertAfter(XPathNavigator)	使用所指定 XPathNavigator 物件中的節點，在目前選取的節點之後建立新的同層級節點。 (繼承來源 XPathNavigator)
InsertBefore()	傳回 XmlWriter 物件，此物件用來在目前選取的節點之前建立新的同層級節點。 (繼承來源 XPathNavigator)
InsertBefore(String)	使用指定的 XML 字串，在目前選取的節點之前建立新的同層級節點。 (繼承來源 XPathNavigator)
InsertBefore(XmlReader)	使用指定之 XmlReader 物件的 XML 內容，在目前選取的節點之前建立新的同層級節點。 (繼承來源 XPathNavigator)
InsertBefore(XPathNavigator)	使用所指定 XPathNavigator 中的節點，在目前所選節點之前建立新的同層級節點。 (繼承來源 XPathNavigator)
InsertElementAfter(String, String, String, String)	使用命名空間前置詞、區域名稱以及有指定值的指定命名空間 URI，在目前的節點之後建立新的同層級項目。 (繼承來源 XPathNavigator)
InsertElementBefore(String, String, String, String)	使用命名空間前置詞、區域名稱以及有指定值的指定命名空間 URI，在目前的節點之前建立新的同層級項目。 (繼承來源 XPathNavigator)
IsDescendant(XPathNavigator)	判斷指定的 XPathNavigator 是否為目前 XPathNavigator 的子代 (Descendant)。 (繼承來源 XPathNavigator)
IsSamePosition(XPathNavigator)	在衍生類別中覆寫時，請判斷目前的 XPathNavigator 是否和指定的 XPathNavigator 位在相同的位置。 (繼承來源 XPathNavigator)
LookupNamespace(String)	取得指定前置詞的命名空間 URI。 (繼承來源 XPathNavigator)
LookupPrefix(String)	取得為指定命名空間 URI 宣告的前置詞。 (繼承來源 XPathNavigator)
Matches(String)	判斷目前的節點是否符合指定的 XPath 運算式。 (繼承來源 XPathNavigator)
Matches(XPathExpression)	判斷目前節點是否符合指定的 XPathExpression。 (繼承來源 XPathNavigator)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
MoveTo(XPathNavigator)	在衍生類別中覆寫時，將 XPathNavigator 移至與指定 XPathNavigator 相同的位置上。 (繼承來源 XPathNavigator)
MoveToAttribute(String, String)	將 XPathNavigator 移至具有相符的區域名稱和命名空間 URI 的屬性。 (繼承來源 XPathNavigator)
MoveToChild(String, String)	將 XPathNavigator 移到具有指定區域名稱和命名空間 URI 的子節點。 (繼承來源 XPathNavigator)
MoveToChild(XPathNodeType)	將 XPathNavigator 移到指定 XPathNodeType 的子節點。 (繼承來源 XPathNavigator)
MoveToFirst()	將 XPathNavigator 移至目前節點的第一個同層級節點。 (繼承來源 XPathNavigator)
MoveToFirstAttribute()	在衍生類別中覆寫時，將 XPathNavigator 移至目前節點的第一個屬性。 (繼承來源 XPathNavigator)
MoveToFirstChild()	在衍生類別中覆寫時，將 XPathNavigator 移至目前節點的第一個子節點。 (繼承來源 XPathNavigator)
MoveToFirstNamespace()	將 XPathNavigator 移至目前節點的第一個命名空間節點。 (繼承來源 XPathNavigator)
MoveToFirstNamespace(XPathNamespaceScope)	在衍生類別中覆寫時，將 XPathNavigator 移至符合指定 XPathNamespaceScope 的第一個命名空間節點。 (繼承來源 XPathNavigator)
MoveToFollowing(String, String)	會根據文件順序，將 XPathNavigator 移到具有指定區域名稱和命名空間 URI 的項目。 (繼承來源 XPathNavigator)
MoveToFollowing(String, String, XPathNavigator)	會根據文件順序，將 XPathNavigator 移到指定界限之區域名稱和指定命名空間 URI 的項目。 (繼承來源 XPathNavigator)
MoveToFollowing(XPathNodeType)	會根據文件順序，將 XPathNavigator 移至下列指定 XPathNodeType 的項目。 (繼承來源 XPathNavigator)
MoveToFollowing(XPathNodeType, XPathNavigator)	會根據文件順序，將 XPathNavigator 移至下列指定界限之指定 XPathNodeType 的項目。 (繼承來源 XPathNavigator)
MoveToId(String)	在衍生類別中覆寫時，移至具有 類型 ID 屬性的節點，其值符合指定的 String 。 (繼承來源 XPathNavigator)
MoveToNamespace(String)	將 XPathNavigator 移至具有指定命名空間前置詞的命名空間節點。 (繼承來源 XPathNavigator)
MoveToNext()	在衍生類別中覆寫時，將 XPathNavigator 移至目前節點的下一個同層級節點。 (繼承來源 XPathNavigator)
MoveToNext(String, String)	將 XPathNavigator 移到具有指定區域名稱和命名空間 URI 的下一個同層級節點。 (繼承來源 XPathNavigator)
MoveToNext(XPathNodeType)	將 XPathNavigator 移至目前節點中符合指定 XPathNodeType 的下一個同層級節點。 (繼承來源 XPathNavigator)
MoveToNextAttribute()	在衍生類別中覆寫時，將 XPathNavigator 移至下一個屬性。 (繼承來源 XPathNavigator)
MoveToNextNamespace()	將 XPathNavigator 移至下一個命名空間節點。 (繼承來源 XPathNavigator)
MoveToNextNamespace(XPathNamespaceScope)	在衍生類別中覆寫時，將 XPathNavigator 移至符合指定 XPathNamespaceScope 的下一個命名空間節點。 (繼承來源 XPathNavigator)
MoveToParent()	在衍生類別中覆寫時，將 XPathNavigator 移至目前節點的父節點。 (繼承來源 XPathNavigator)
MoveToPrevious()	在衍生類別中覆寫時，將 XPathNavigator 移至目前節點的上一個同層級節點。 (繼承來源 XPathNavigator)
MoveToRoot()	將 XPathNavigator 移至目前節點所屬的根節點。 (繼承來源 XPathNavigator)
PrependChild()	傳回 XmlWriter 物件，此物件用來在目前節點的子節點清單開頭建立新的子節點。 (繼承來源 XPathNavigator)
PrependChild(String)	使用指定的 XML 字串，在目前節點的子節點清單開頭建立新的子節點。 (繼承來源 XPathNavigator)
PrependChild(XmlReader)	使用指定之 XmlReader 物件的 XML 內容，在目前節點的子節點清單開頭建立新的子節點。 (繼承來源 XPathNavigator)
PrependChild(XPathNavigator)	使用指定 XPathNavigator 物件中的節點，在目前節點的子節點清單開頭建立新的子節點。 (繼承來源 XPathNavigator)
PrependChildElement(String, String, String, String)	使用命名空間前置詞、區域名稱以及有指定值的指定命名空間 URI，在目前節點的子節點清單開頭建立新的子項目。 (繼承來源 XPathNavigator)
ReadSubtree()	傳回 XmlReader 物件，此物件包含目前的節點和它的子節點。 (繼承來源 XPathNavigator)
ReplaceRange(XPathNavigator)	取代從目前節點到指定節點的某範圍之同層級節點。 (繼承來源 XPathNavigator)
ReplaceSelf(String)	將目前的節點取代為指定字串的內容。 (繼承來源 XPathNavigator)
ReplaceSelf(XmlReader)	將目前的節點取代為指定 XmlReader 物件的內容。 (繼承來源 XPathNavigator)
ReplaceSelf(XPathNavigator)	將目前的節點取代為指定 XPathNavigator 物件的內容。 (繼承來源 XPathNavigator)
Select(String)	使用指定的 XPath 運算式來選取節點集。 (繼承來源 XPathNavigator)
Select(String, IXmlNamespaceResolver)	使用指定的 XPath 運算式並搭配用來解析命名空間前置詞的 IXmlNamespaceResolver，以選取節點集。 (繼承來源 XPathNavigator)
Select(XPathExpression)	使用指定的 XPathExpression 來選取節點集。 (繼承來源 XPathNavigator)
SelectAncestors(String, String, Boolean)	選取目前節點中，所有具有指定區域名稱和命名空間 URI 的祖系節點。 (繼承來源 XPathNavigator)
SelectAncestors(XPathNodeType, Boolean)	選取目前節點中，所有具有相符 XPathNodeType 的祖系節點。 (繼承來源 XPathNavigator)
SelectChildren(String, String)	選取目前節點中，所有具有指定區域名稱和命名空間 URI 的子節點。 (繼承來源 XPathNavigator)
SelectChildren(XPathNodeType)	選取目前節點中，所有具有相符之 XPathNodeType 的子節點。 (繼承來源 XPathNavigator)
SelectDescendants(String, String, Boolean)	選取目前節點中，所有具有指定區域名稱和命名空間 URI 的子代節點。 (繼承來源 XPathNavigator)
SelectDescendants(XPathNodeType, Boolean)	選取目前節點中，所有具有相符 XPathNodeType 的子代節點。 (繼承來源 XPathNavigator)
SelectSingleNode(String)	使用指定的 XPath 查詢，於 XPathNavigator 中選取單一節點。 (繼承來源 XPathNavigator)
SelectSingleNode(String, IXmlNamespaceResolver)	使用指定的 XPath 查詢並搭配指定的 XPathNavigator 物件，在 IXmlNamespaceResolver 物件中選取單一節點，以解析命名空間前置詞。 (繼承來源 XPathNavigator)
SelectSingleNode(XPathExpression)	使用指定的 XPathNavigator 物件，於 XPathExpression 中選取單一節點。 (繼承來源 XPathNavigator)
SetTypedValue(Object)	設定目前節點的類型值。 (繼承來源 XPathNavigator)
SetValue(String)	設定目前節點的值。 (繼承來源 XPathNavigator)
ToString()	取得目前節點的文字值。 (繼承來源 XPathNavigator)
ValueAs(Type)	傳回項目的值，做為指定型別。 (繼承來源 XPathItem)
ValueAs(Type, IXmlNamespaceResolver)	取得目前節點的值做為指定的 Type，透過的方式是使用指定的 IXmlNamespaceResolver 物件來解析命名空間前置詞。 (繼承來源 XPathNavigator)
WriteSubtree(XmlWriter)	將目前節點和其子節點的資料流導向指定的 XmlWriter 物件。 (繼承來源 XPathNavigator)

明確介面實作

ICloneable.Clone()

建立 XPathNavigator 物件的新複本。 (繼承來源 XPathNavigator)