DocumentBase.SelectSingleNode(String, String, Boolean) Método

Definición

Espacio de nombres:

Microsoft.Office.Tools.Word

Ensamblado:

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

Devuelve un objeto XMLNode que representa el primer nodo del documento que se corresponde con el parámetro XPath.

public Microsoft.Office.Interop.Word.XMLNode SelectSingleNode (string xPath, string prefixMapping, bool fastSearchSkippingTextNodes);

member this.SelectSingleNode : string * string * bool -> Microsoft.Office.Interop.Word.XMLNode

Public Function SelectSingleNode (xPath As String, Optional prefixMapping As String, Optional fastSearchSkippingTextNodes As Boolean) As XMLNode

Parámetros

xPath

String

Cadena XPath válida. Para obtener más información sobre Xpath, vea Referencia de Xpath.

prefixMapping

String

Proporciona el prefijo del esquema que se va a utilizar para la búsqueda. Use el parámetro si XPath el PrefixMapping parámetro usa nombres para buscar elementos.

fastSearchSkippingTextNodes

Boolean

true omite todos los nodos de texto en la búsqueda del nodo especificado. false incluye los nodos de texto en la búsqueda. El valor predeterminado es false.

Devoluciones

XMLNode

Un objeto XMLNode que representa el primer nodo que coincide con el parámetro XPath en el documento; null si no se encuentra ningún nodo que coincida con el parámetro XPath.

Ejemplos

En el ejemplo de código siguiente se muestra cómo especificar los XPath parámetros y PrefixMapping al llamar al SelectSingleNode método . Para usar este ejemplo, ejecútelo desde la ThisDocument clase en un proyecto de nivel de documento.

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.");
    }
}

Private Sub DocumentSelectSingleNode()
    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.XMLNode = Me.SelectSingleNode(XPath, _
            PrefixMapping, True)
    Else
        MessageBox.Show("The document does not contain a " + _
            "schema reference.")
    End If
End Sub

Comentarios

Establecer el parámetro para true disminuir el FastSearchSkippingTextNodes rendimiento porque Microsoft Office Word busca en todos los nodos de un documento el texto contenido en el nodo.

Parámetros opcionales

Para obtener información sobre los parámetros opcionales, vea Parámetros opcionales en soluciones de Office.