XPathNavigator Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Poskytuje model kurzoru pro navigaci a úpravy dat XML.
public ref class XPathNavigator abstract : System::Xml::XPath::XPathItem, ICloneable, System::Xml::IXmlNamespaceResolver, System::Xml::XPath::IXPathNavigable
public ref class XPathNavigator abstract : System::Xml::XPath::XPathItem, System::Xml::IXmlNamespaceResolver, System::Xml::XPath::IXPathNavigable
public ref class XPathNavigator abstract : ICloneable
public abstract class XPathNavigator : System.Xml.XPath.XPathItem, ICloneable, System.Xml.IXmlNamespaceResolver, System.Xml.XPath.IXPathNavigable
public abstract class XPathNavigator : System.Xml.XPath.XPathItem, System.Xml.IXmlNamespaceResolver, System.Xml.XPath.IXPathNavigable
public abstract class XPathNavigator : ICloneable
type XPathNavigator = class
inherit XPathItem
interface ICloneable
interface IXmlNamespaceResolver
interface IXPathNavigable
type XPathNavigator = class
inherit XPathItem
interface IXmlNamespaceResolver
interface IXPathNavigable
type XPathNavigator = class
interface ICloneable
type XPathNavigator = class
inherit XPathItem
interface ICloneable
interface IXPathNavigable
interface IXmlNamespaceResolver
Public MustInherit Class XPathNavigator
Inherits XPathItem
Implements ICloneable, IXmlNamespaceResolver, IXPathNavigable
Public MustInherit Class XPathNavigator
Inherits XPathItem
Implements IXmlNamespaceResolver, IXPathNavigable
Public MustInherit Class XPathNavigator
Implements ICloneable
- Dědičnost
- Dědičnost
-
XPathNavigator
- Odvozené
- Implementuje
Poznámky
XPathNavigator Třída v System.Xml.XPath oboru názvů je abstraktní třída, která definuje model kurzoru pro navigaci a úpravu položek informací XML jako instance datového modelu XQuery 1.0 a XPath 2.0.
Objekt XPathNavigator je vytvořen z třídy, která implementuje IXPathNavigable rozhraní, jako XPathDocument jsou třídy a XmlDocument třídy. XPathNavigator objekty vytvořené XPathDocument objekty jsou jen pro čtení, zatímco XPathNavigator objekty vytvořené XmlDocument objekty lze upravovat. Stav XPathNavigator objektu jen pro čtení nebo upravitelný stav je určen pomocí CanEdit vlastnosti XPathNavigator třídy.
Další informace o zpracování dat XML pomocí datového modelu XPath naleznete v tématu Zpracování dat XML pomocí XPath datového modelu .
Důležité
Výjimky vyvolané v důsledku použití XPathNavigator třídy, například XPathException třídy, mohou obsahovat citlivé informace, které by neměly být vystaveny v nedůvěryhodných scénářích. Výjimky by se měly správně zpracovat, aby tyto citlivé informace nebyly zpřístupněny v nedůvěryhodných scénářích.
Poznámky pro implementátory
Když dědíte z XPathNavigator třídy, musíte přepsat následující členy:
Konstruktory
| Name | Description |
|---|---|
| XPathNavigator() |
Inicializuje novou instanci XPathNavigator třídy. |
Vlastnosti
| Name | Description |
|---|---|
| BaseURI |
Při přepsání v odvozené třídě získá základní identifikátor URI pro aktuální uzel. |
| CanEdit |
Získá hodnotu, která označuje, zda XPathNavigator může upravit podkladová data XML. |
| HasAttributes |
Získá hodnotu, která označuje, zda aktuální uzel má nějaké atributy. |
| HasChildren |
Získá hodnotu, která označuje, zda aktuální uzel má jakékoli podřízené uzly. |
| InnerXml |
Získá nebo nastaví kód představující podřízené uzly aktuálního uzlu. |
| IsEmptyElement |
Při přepsání v odvozené třídě získá hodnotu, která označuje, zda aktuální uzel je prázdný prvek bez značky koncového prvku. |
| IsNode |
Získá hodnotu, která označuje, zda aktuální uzel představuje uzel XPath. |
| LocalName |
Při přepsání v odvozené třídě získá Name aktuální uzel bez jakékoli předpony oboru názvů. |
| Name |
Při přepsání v odvozené třídě získá kvalifikovaný název aktuálního uzlu. |
| NamespaceURI |
Při přepsání v odvozené třídě získá identifikátor URI oboru názvů aktuálního uzlu. |
| NameTable |
Při přepsání v odvozené třídě získá XmlNameTable z XPathNavigator. |
| NavigatorComparer |
IEqualityComparer Získá použití pro porovnání XPathNavigator rovnosti objektů. |
| NodeType |
Při přepsání v odvozené třídě získá XPathNodeType aktuální uzel. |
| OuterXml |
Získá nebo nastaví značky představující počáteční a koncové značky aktuálního uzlu a jeho podřízených uzlů. |
| Prefix |
Při přepsání v odvozené třídě získá předponu oboru názvů přidruženou k aktuálnímu uzlu. |
| SchemaInfo |
Získá informace o schématu, které byly přiřazeny k aktuálnímu uzlu v důsledku ověření schématu. |
| TypedValue |
Získá aktuální uzel jako boxovaný objekt nejvhodnějšího typu .NET. |
| UnderlyingObject |
Používá se v XPathNavigator implementacích, které poskytují "virtualizované" zobrazení XML v úložišti, k zajištění přístupu k podkladovým objektům. |
| Value |
Při přepsání v odvozené třídě získá řetězcovou hodnotu položky. |
| Value |
Při přepsání v odvozené třídě získá |
| ValueAsBoolean |
Získá hodnotu aktuálního uzlu jako Boolean. |
| ValueAsDateTime |
Získá hodnotu aktuálního uzlu jako DateTime. |
| ValueAsDouble |
Získá hodnotu aktuálního uzlu jako Double. |
| ValueAsInt |
Získá hodnotu aktuálního uzlu jako Int32. |
| ValueAsLong |
Získá hodnotu aktuálního uzlu jako Int64. |
| ValueType |
Získá .NET Type aktuálního uzlu. |
| XmlLang |
|
| XmlType |
XmlSchemaType Získá informace pro aktuální uzel. |
Metody
| Name | Description |
|---|---|
| AppendChild() |
XmlWriter Vrátí objekt použitý k vytvoření jednoho nebo několika nových podřízených uzlů na konci seznamu podřízených uzlů aktuálního uzlu. |
| AppendChild(String) |
Vytvoří nový podřízený uzel na konci seznamu podřízených uzlů aktuálního uzlu pomocí zadaného datového řetězce XML. |
| AppendChild(XmlReader) |
Vytvoří nový podřízený uzel na konci seznamu podřízených uzlů aktuálního uzlu pomocí obsahu XML zadaného objektu XmlReader . |
| AppendChild(XPathNavigator) |
Vytvoří nový podřízený uzel na konci seznamu podřízených uzlů aktuálního uzlu pomocí uzlů v zadaném XPathNavigator seznamu. |
| AppendChildElement(String, String, String, String) |
Vytvoří nový uzel podřízeného prvku na konci seznamu podřízených uzlů aktuálního uzlu pomocí předpony oboru názvů, místního názvu a identifikátoru URI oboru názvů zadaného se zadanou hodnotou. |
| CheckValidity(XmlSchemaSet, ValidationEventHandler) |
Ověřuje, že data XML ve XPathNavigator formátu XML odpovídají zadanému schématu XSD (XML Schema Definition Language). |
| Clone() |
Při přepsání v odvozené třídě vytvoří nové XPathNavigator umístění ve stejném uzlu jako tento XPathNavigator. |
| ComparePosition(XPathNavigator) |
Porovná pozici aktuálního s XPathNavigator pozicí zadaného XPathNavigator . |
| Compile(String) |
Zkompiluje řetězec představující výraz XPath a vrátí XPathExpression objekt. |
| CreateAttribute(String, String, String, String) |
Vytvoří uzel atributu na aktuálním uzlu elementu pomocí předpony oboru názvů, místního názvu a identifikátoru URI oboru názvů zadaného se zadanou hodnotou. |
| CreateAttributes() |
XmlWriter Vrátí objekt použitý k vytvoření nových atributů pro aktuální prvek. |
| CreateNavigator() |
Vrátí kopii XPathNavigator. |
| DeleteRange(XPathNavigator) |
Odstraní rozsah uzlů na stejné úrovni z aktuálního uzlu na zadaný uzel. |
| DeleteSelf() |
Odstraní aktuální uzel a jeho podřízené uzly. |
| Equals(Object) |
Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
| Evaluate(String, IXmlNamespaceResolver) |
Vyhodnotí zadaný výraz XPath a vrátí zadaný výsledek pomocí objektu IXmlNamespaceResolver určeného k překladu předpon oboru názvů ve výrazu XPath. |
| Evaluate(String) |
Vyhodnotí zadaný výraz XPath a vrátí zadaný výsledek. |
| Evaluate(XPathExpression, XPathNodeIterator) |
Použije zadaný kontext k vyhodnocení XPathExpressiona vrátí zadaný výsledek. |
| Evaluate(XPathExpression) |
Vyhodnotí zadaný XPathExpression výsledek a vrátí ho. |
| GetAttribute(String, String) |
Získá hodnotu atributu se zadaným místním názvem a identifikátorem URI oboru názvů. |
| GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
| GetNamespace(String) |
Vrátí hodnotu uzlu oboru názvů odpovídající zadanému místnímu názvu. |
| GetNamespacesInScope(XmlNamespaceScope) |
Vrátí obory názvů v oboru aktuálního uzlu. |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| InsertAfter() |
XmlWriter Vrátí objekt použitý k vytvoření nového uzlu na stejné úrovni za aktuálně vybraným uzlem. |
| InsertAfter(String) |
Vytvoří nový uzel na stejné úrovni za aktuálně vybraným uzlem pomocí zadaného řetězce XML. |
| InsertAfter(XmlReader) |
Vytvoří nový uzel na stejné úrovni za aktuálně vybraným uzlem pomocí obsahu XML zadaného objektu XmlReader . |
| InsertAfter(XPathNavigator) |
Vytvoří nový uzel na stejné úrovni za aktuálně vybraným uzlem pomocí uzlů v zadaném objektu XPathNavigator . |
| InsertBefore() |
XmlWriter Vrátí objekt použitý k vytvoření nového uzlu na stejné úrovni před aktuálně vybraným uzlem. |
| InsertBefore(String) |
Vytvoří nový uzel na stejné úrovni před aktuálně vybraným uzlem pomocí zadaného řetězce XML. |
| InsertBefore(XmlReader) |
Vytvoří nový uzel na stejné úrovni před aktuálně vybraným uzlem pomocí obsahu XML zadaného objektu XmlReader . |
| InsertBefore(XPathNavigator) |
Vytvoří nový uzel na stejné úrovni před aktuálně vybraným uzlem pomocí uzlů v zadaném XPathNavigator seznamu. |
| InsertElementAfter(String, String, String, String) |
Vytvoří nový prvek na stejné úrovni za aktuálním uzlem pomocí předpony oboru názvů, místního názvu a identifikátoru URI oboru názvů se zadanou hodnotou. |
| InsertElementBefore(String, String, String, String) |
Vytvoří nový prvek na stejné úrovni před aktuálním uzlem pomocí předpony oboru názvů, místního názvu a identifikátoru URI oboru názvů se zadanou hodnotou. |
| IsDescendant(XPathNavigator) |
Určuje, zda je zadaný XPathNavigator potomkem aktuálního XPathNavigator. |
| IsSamePosition(XPathNavigator) |
Při přepsání v odvozené třídě určuje, zda aktuální XPathNavigator je na stejné pozici jako zadaná XPathNavigator. |
| LookupNamespace(String) |
Získá identifikátor URI oboru názvů pro zadanou předponu. |
| LookupPrefix(String) |
Získá předponu deklarovanou pro zadaný identifikátor URI oboru názvů. |
| Matches(String) |
Určuje, zda aktuální uzel odpovídá zadanému výrazu XPath. |
| Matches(XPathExpression) |
Určuje, zda aktuální uzel odpovídá zadanému XPathExpression. |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| MoveTo(XPathNavigator) |
Při přepsání v odvozené třídě se přesune na XPathNavigator stejnou pozici jako zadaná XPathNavigator. |
| MoveToAttribute(String, String) |
Přesune atribut XPathNavigator s odpovídajícím místním názvem a identifikátorem URI oboru názvů. |
| MoveToChild(String, String) |
XPathNavigator Přesune podřízený uzel se zadaným místním názvem a identifikátorem URI oboru názvů. |
| MoveToChild(XPathNodeType) |
Přesune podřízený XPathNavigator uzel zadaného XPathNodeType uzlu. |
| MoveToFirst() |
Přesune XPathNavigator na první sourozenecký uzel aktuálního uzlu. |
| MoveToFirstAttribute() |
Při přepsání v odvozené třídě přesune XPathNavigator na první atribut aktuálního uzlu. |
| MoveToFirstChild() |
Při přepsání v odvozené třídě přesune na XPathNavigator první podřízený uzel aktuálního uzlu. |
| MoveToFirstNamespace() |
Přesune na XPathNavigator první uzel oboru názvů aktuálního uzlu. |
| MoveToFirstNamespace(XPathNamespaceScope) |
Při přepsání v odvozené třídě přesune XPathNavigator na první uzel oboru názvů, který odpovídá XPathNamespaceScope zadané. |
| MoveToFollowing(String, String, XPathNavigator) |
XPathNavigator Přesune objekt do elementu se zadaným místním názvem a identifikátorem URI oboru názvů do zadané hranice v pořadí dokumentu. |
| MoveToFollowing(String, String) |
XPathNavigator Přesune prvek s místním názvem a identifikátorem URI oboru názvů zadaným v pořadí dokumentu. |
| MoveToFollowing(XPathNodeType, XPathNavigator) |
XPathNavigator Přesune následující prvek zadaného XPathNodeType prvku do zadané hranice v pořadí dokumentu. |
| MoveToFollowing(XPathNodeType) |
XPathNavigator Přesune následující prvek zadaného XPathNodeType v pořadí dokumentu. |
| MoveToId(String) |
Při přepsání v odvozené třídě se přesune na uzel, který má atribut typu |
| MoveToNamespace(String) |
Přesune uzel XPathNavigator oboru názvů se zadanou předponou oboru názvů. |
| MoveToNext() |
Při přepsání v odvozené třídě přesune XPathNavigator na další uzel na stejné úrovni aktuálního uzlu. |
| MoveToNext(String, String) |
Přesune na XPathNavigator další uzel na stejné úrovni se zadaným místním názvem a identifikátorem URI oboru názvů. |
| MoveToNext(XPathNodeType) |
XPathNavigator Přesune na další uzel na stejné úrovni aktuálního uzlu, který odpovídá zadanému XPathNodeType uzlu. |
| MoveToNextAttribute() |
Při přepsání v odvozené třídě přesune XPathNavigator na další atribut. |
| MoveToNextNamespace() |
Přesune uzel XPathNavigator dalšího oboru názvů. |
| MoveToNextNamespace(XPathNamespaceScope) |
Při přepsání v odvozené třídě se přesune XPathNavigator na další uzel oboru názvů odpovídající zadanému XPathNamespaceScope uzlu. |
| MoveToParent() |
Při přepsání v odvozené třídě přesune do XPathNavigator nadřazeného uzlu aktuálního uzlu. |
| MoveToPrevious() |
Při přepsání v odvozené třídě přesune na XPathNavigator předchozí uzel na stejné úrovni aktuálního uzlu. |
| MoveToRoot() |
Přesune XPathNavigator na kořenový uzel, ke kterému patří aktuální uzel. |
| PrependChild() |
XmlWriter Vrátí objekt použitý k vytvoření nového podřízeného uzlu na začátku seznamu podřízených uzlů aktuálního uzlu. |
| PrependChild(String) |
Vytvoří nový podřízený uzel na začátku seznamu podřízených uzlů aktuálního uzlu pomocí zadaného řetězce XML. |
| PrependChild(XmlReader) |
Vytvoří nový podřízený uzel na začátku seznamu podřízených uzlů aktuálního uzlu pomocí obsahu XML zadaného objektu XmlReader . |
| PrependChild(XPathNavigator) |
Vytvoří nový podřízený uzel na začátku seznamu podřízených uzlů aktuálního uzlu pomocí uzlů v zadaném objektu XPathNavigator . |
| PrependChildElement(String, String, String, String) |
Vytvoří nový podřízený prvek na začátku seznamu podřízených uzlů aktuálního uzlu pomocí předpony oboru názvů, místního názvu a identifikátoru URI oboru názvů zadaného se zadanou hodnotou. |
| ReadSubtree() |
XmlReader Vrátí objekt, který obsahuje aktuální uzel a jeho podřízené uzly. |
| ReplaceRange(XPathNavigator) |
Nahradí rozsah uzlů na stejné úrovni od aktuálního uzlu k zadanému uzlu. |
| ReplaceSelf(String) |
Nahradí aktuální uzel obsahem zadaného řetězce. |
| ReplaceSelf(XmlReader) |
Nahradí aktuální uzel obsahem zadaného objektu XmlReader . |
| ReplaceSelf(XPathNavigator) |
Nahradí aktuální uzel obsahem zadaného objektu XPathNavigator . |
| Select(String, IXmlNamespaceResolver) |
Vybere sadu uzlů pomocí zadaného výrazu XPath s objektem IXmlNamespaceResolver určeným k překladu předpon oboru názvů. |
| Select(String) |
Vybere sadu uzlů pomocí zadaného výrazu XPath. |
| Select(XPathExpression) |
Vybere sadu uzlů pomocí zadaného XPathExpressionparametru . |
| SelectAncestors(String, String, Boolean) |
Vybere všechny nadřazené uzly aktuálního uzlu, které mají zadaný místní název a identifikátor URI oboru názvů. |
| SelectAncestors(XPathNodeType, Boolean) |
Vybere všechny nadřazené uzly aktuálního uzlu, které mají odpovídající XPathNodeType. |
| SelectChildren(String, String) |
Vybere všechny podřízené uzly aktuálního uzlu, které mají zadaný místní název a identifikátor URI oboru názvů. |
| SelectChildren(XPathNodeType) |
Vybere všechny podřízené uzly aktuálního uzlu, které mají odpovídající XPathNodeType. |
| SelectDescendants(String, String, Boolean) |
Vybere všechny potomky aktuálního uzlu se zadaným místním názvem a identifikátorem URI oboru názvů. |
| SelectDescendants(XPathNodeType, Boolean) |
Vybere všechny potomky aktuálního uzlu, které mají odpovídající XPathNodeType. |
| SelectSingleNode(String, IXmlNamespaceResolver) |
Vybere jeden uzel v objektu XPathNavigator pomocí zadaného dotazu XPath s objektem IXmlNamespaceResolver určeným k překladu předpon oboru názvů. |
| SelectSingleNode(String) |
Vybere jeden uzel v zadaném XPathNavigator dotazu XPath. |
| SelectSingleNode(XPathExpression) |
Vybere jeden uzel v zadaném XPathExpression objektuXPathNavigator. |
| SetTypedValue(Object) |
Nastaví zadaná hodnota aktuálního uzlu. |
| SetValue(String) |
Nastaví hodnotu aktuálního uzlu. |
| ToString() |
Získá text hodnotu aktuálního uzlu. |
| ValueAs(Type, IXmlNamespaceResolver) |
Získá hodnotu aktuálního uzlu jako zadanou Type pomocí objektu IXmlNamespaceResolver určeného k překladu předpon oboru názvů. |
| ValueAs(Type) |
Vrátí hodnotu položky jako zadaný typ. (Zděděno od XPathItem) |
| WriteSubtree(XmlWriter) |
Streamuje aktuální uzel a jeho podřízené uzly do zadaného objektu XmlWriter . |
Explicitní implementace rozhraní
| Name | Description |
|---|---|
| ICloneable.Clone() |
Vytvoří novou kopii objektu XPathNavigator . |