CreateNavigator

CompositeNode.CreateNavigator method

Creates navigator which can be used to traverse and read nodes.

[EditorBrowsable(EditorBrowsableState.Never)]
public XPathNavigator CreateNavigator()

Examples

Shows how to create an XPathNavigator, and then use it to traverse and read nodes.

Document doc = new Document();
XPathNavigator navigator = doc.CreateNavigator();

if (navigator != null)
{
    Assert.That(navigator.Name, Is.EqualTo("Document"));
    Assert.That(navigator.MoveToNext(), Is.EqualTo(false));
    Assert.That(navigator.SelectChildren(XPathNodeType.All).Count, Is.EqualTo(1));

    // The document tree has the document, first section,
    // body, and first paragraph as nodes, with each being an only child of the previous.
    // We can add a few more to give the tree some branches for the navigator to traverse.
    DocumentBuilder docBuilder = new DocumentBuilder(doc);
    docBuilder.Write("Section 1, Paragraph 1. ");
    docBuilder.InsertParagraph();
    docBuilder.Write("Section 1, Paragraph 2. ");
    doc.AppendChild(new Section(doc));
    docBuilder.MoveToSection(1);
    docBuilder.Write("Section 2, Paragraph 1. ");

    // Use our navigator to print a map of all the nodes in the document to the console.
    StringBuilder stringBuilder = new StringBuilder();
    MapDocument(navigator, stringBuilder, 0);
    Console.Write(stringBuilder.ToString());
}

Shows how to create an XPathNavigator, and then use it to traverse and read nodes (MapDocument).

/// <summary>
/// Traverses all children of a composite node and map the structure in the style of a directory tree.
/// The amount of space indentation indicates depth relative to the initial node.
/// Prints the text contents of the current node only if it is a Run.
/// </summary>
private static void MapDocument(XPathNavigator navigator, StringBuilder stringBuilder, int depth)
{
    do
    {
        stringBuilder.Append(' ', depth);
        stringBuilder.Append(navigator.Name + ": ");

        if (navigator.Name == "Run")
        {
            stringBuilder.Append(navigator.Value);
        }

        stringBuilder.Append('\n');

        if (navigator.HasChildren)
        {
            navigator.MoveToFirstChild();
            MapDocument(navigator, stringBuilder, depth + 1);
            navigator.MoveToParent();
        }
    } while (navigator.MoveToNext());
}

See Also

CompositeNode.AppendChild CompositeNode.GetChild