DocumentBase.SelectNodes(String, String, Boolean) Method

Reference

Definition

Namespace:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets a XMLNodes collection that represents all the nodes that match the XPath parameter in the order in which they appear in the document.

public Microsoft.Office.Interop.Word.XMLNodes SelectNodes (string xPath, string prefixMapping, bool fastSearchSkippingTextNodes);

member this.SelectNodes : string * string * bool -> Microsoft.Office.Interop.Word.XMLNodes

Public Function SelectNodes (xPath As String, Optional prefixMapping As String, Optional fastSearchSkippingTextNodes As Boolean) As XMLNodes

Parameters

xPath: String

A valid XPath string. For more information on XPath, see XPath Reference.

prefixMapping: String

Provides the prefix in the schema against which to perform the search. Use the PrefixMapping parameter if your XPath parameter uses names to search for elements.

fastSearchSkippingTextNodes: Boolean

true skips all text nodes while searching for the specified node. false includes text nodes in the search. Default value is false.

Returns

XMLNodes

A XMLNodes collection that represents all the nodes that match the XPath parameter in the order in which they appear in the document; null if no nodes matching the XPath parameter are found.

Examples

The following code example demonstrates how to specify the XPath and PrefixMapping parameters when calling the SelectNodes method. To use this example, run it from the ThisDocument class in a document-level project.

private void DocumentSelectNodes()
{
    if (this.XMLSchemaReferences.Count > 0)
    {
        string XPath = "/x:catalog/x:book/x:title";
        object key = 1;
        string PrefixMapping = "xmlns:x=\"" +
            this.XMLSchemaReferences[key].NamespaceURI +
            "\"";
        Word.XMLNodes nodes = this.SelectNodes(XPath, 
            PrefixMapping, true);
    }
    else
    {
        MessageBox.Show("The document does not contain a " +
            "schema reference.");
    }
}

Private Sub DocumentSelectNodes()
    If Me.XMLSchemaReferences.Count > 0 Then
        Dim XPath As String = "/x:catalog/x:book/x:title"
        Dim PrefixMapping As String = "xmlns:x=""" + _
            Me.XMLSchemaReferences(1).NamespaceURI + """"
        Dim node As Word.XMLNodes = Me.SelectNodes(XPath, _
            PrefixMapping, True)
    Else
        MessageBox.Show("The document does not contain a " + _
            "schema reference.")
    End If
End Sub

Remarks

Setting the FastSearchSkippingTextNodes parameter to true diminishes performance, because Microsoft Office Word searches all nodes in a document against the text contained in the node.

Optional Parameters

For information on optional parameters, see Optional Parameters in Office Solutions.

Applies to

Share via