XPathNavigator Class (System.Xml.XPath)

.NET Framework Class Library

XPathNavigator Class

Provides a cursor model for navigating and editing XML data.

Namespace: System.Xml.XPath
Assembly: System.Xml (in System.Xml.dll)

Syntax

Visual Basic (Declaration)

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

Visual Basic (Usage)

Dim instance As XPathNavigator

public abstract class XPathNavigator : XPathItem, 
    ICloneable, IXPathNavigable, IXmlNamespaceResolver

Visual C++

public ref class XPathNavigator abstract : public XPathItem, 
    ICloneable, IXPathNavigable, IXmlNamespaceResolver

JScript

public abstract class XPathNavigator extends XPathItem implements ICloneable, IXPathNavigable, IXmlNamespaceResolver

Remarks

The XPathNavigator class in the System.Xml.XPath namespace is an abstract class which defines a cursor model for navigating and editing XML information items as instances of the XQuery 1.0 and XPath 2.0 Data Model.

An XPathNavigator object is created from a class that implements the IXPathNavigable interface such as the XPathDocument and XmlDocument classes. XPathNavigator objects created by XPathDocument objects are read-only while XPathNavigator objects created by XmlDocument objects can be edited. An XPathNavigator object's read-only or editable status is determined using the CanEdit property of the XPathNavigator class.

For more information about processing XML data using the XPath data model, see the Process XML Data Using the XPath Data Model topic.

Security Note:
Exceptions raised as a result of using the XPathNavigator class, such as the XPathException 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.

Notes to Inheritors:

When you inherit from the XPathNavigator class, you must override the following members:

Inheritance Hierarchy

System..::.Object
  System.Xml.XPath..::.XPathItem
    System.Xml.XPath..::.XPathNavigator
      System.ServiceModel.Dispatcher..::.SeekableXPathNavigator

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

Reference

XPathNavigator Members

System.Xml.XPath Namespace

Other Resources

Process XML Data Using the XPath Data Model