Export (0) Print
Expand All
Expand Minimize

Document.SelectSingleNode Method

Returns a Microsoft.Office.Interop.Word.XMLNode object that represents the first node in the document that matches the XPath parameter.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in microsoft.office.tools.word.dll)

public virtual XMLNode SelectSingleNode (
	string XPath,
	[OptionalAttribute] string PrefixMapping,
	[OptionalAttribute] bool FastSearchSkippingTextNodes
)

Parameters

XPath

A valid XPath string. For more information on XPath, see the XPath reference documentation on the Microsoft Developer Network (MSDN) Web site.

PrefixMapping

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

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

Return Value

A Microsoft.Office.Interop.Word.XMLNode object that represents the first node that matches the XPath parameter in the document.

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 Understanding Optional Parameters in COM Interop.

The following code example demonstrates how to specify the XPath and PrefixMapping parameters when calling the SelectSingleNode method.

private void DocumentSelectSingleNode()
{
    if (this.XMLSchemaReferences.Count > 0)
    {
        string XPath = "/x:catalog/x:book/x:title";
        object key = 1;

        string PrefixMapping = "xmlns:x=\"" +
            this.XMLSchemaReferences.get_Item(ref key).NamespaceURI +
            "\"";

        Word.XMLNode node = this.SelectSingleNode(XPath, 
            PrefixMapping, true);
    }
    else
    {
        MessageBox.Show("The document does not contain a " +
            "schema reference.");
    }
}

Show:
© 2014 Microsoft