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

Definición

Espacio de nombres:

Microsoft.Office.Tools.Word

Ensamblado:

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

Obtiene una colección XMLNodes que representa todos los nodos que coinciden con el parámetro XPath en el orden en que aparecen en el documento.

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

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

XMLNodes

Una colección XMLNodes que representa todos los nodos que coinciden con el parámetro XPath en el orden en que aparecen 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 SelectNodes método . Para usar este ejemplo, ejecútelo desde la ThisDocument clase en un proyecto de nivel de documento.

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

Comentarios

Establecer el parámetro para true disminuir el FastSearchSkippingTextNodes rendimiento, ya que 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.