XmlNode::CreateNavigator Method ()

 

Creates an XPathNavigator for navigating this object.

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

public:
virtual XPathNavigator^ CreateNavigator()

Return Value

Type: System.Xml.XPath::XPathNavigator^

An XPathNavigator object used to navigate the node. The XPathNavigator is positioned on the node from which the method was called. It is not positioned on the root of the document.

The XPathNavigator provides read-only, random access to data. Because it is optimized for XSLT transformations, it provides performance benefits when used as an input mechanism to the XslTransform::Transform method.

This method is a Microsoft extension to the Document Object Model (DOM).

The following example loads and edits an XML document before performing an XSLT transform.

XmlDocument^ doc = gcnew XmlDocument;
doc->Load( "books.xml" );

// Modify the XML file.
XmlElement^ root = doc->DocumentElement;
root->FirstChild->LastChild->InnerText = "12.95";

// Create an XPathNavigator to use for the transform.
XPathNavigator^ nav = root->CreateNavigator();

// Transform the file.
XslTransform^ xslt = gcnew XslTransform;
xslt->Load( "output.xsl" );
XmlTextWriter^ writer = gcnew XmlTextWriter( "books.html", nullptr );
xslt->Transform( nav, nullptr, writer, nullptr);

.NET Framework
Available since 1.1
Return to top
Show: