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

Definición

Espacio de nombres:

Microsoft.Office.Tools.Word

Ensamblado:

Microsoft.Office.Tools.Word.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 control XMLNode.

public Microsoft.Office.Interop.Word.XMLNodes SelectNodes (string XPath, string PrefixMapping = "", bool FastSearchSkippingTextNodes = true);

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

Public Function SelectNodes (XPath As String, Optional PrefixMapping As String = "", Optional FastSearchSkippingTextNodes As Boolean = true) As XMLNodes

Parámetros

XPath

String

Cadena XPath válida.

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 para omitir todos los nodos de texto en la búsqueda del nodo especificado. false para incluir nodos de texto en la búsqueda. El valor predeterminado es false.

Devoluciones

XMLNodes

Los nodos que coinciden con el parámetro XPath en el orden en que aparecen en el control XMLNode.

Ejemplos

En el ejemplo de código siguiente se usa el SelectNodes método para obtener una colección de los nodos secundarios que coinciden con el parámetro especificado XPath . A continuación, en el ejemplo se muestra el número de nodos que se encontraron. En este ejemplo se supone que el documento actual contiene un XMLNode denominado CustomerNode con un elemento de esquema coincidente que contiene uno o varios nodos secundarios denominados FirstName.

private void DisplayFirstNameNodesCount()
{
    string element = "/x:Customer/x:FirstName";
    string prefix = "xmlns:x='" + 
        this.CustomerFirstNameNode.NamespaceURI + "'";

    Word.XMLNodes nodes = this.CustomerNode.SelectNodes(element, 
        prefix, true);
    MessageBox.Show(nodes.Count + " element(s) were found.");
}

Private Sub DisplayFirstNameNodesCount()
    Dim element As String = "/x:Customer/x:FirstName"
    Dim prefix As String = "xmlns:x='" & _
        Me.CustomerFirstNameNode.NamespaceURI & "'"

    Dim nodes As Word.XMLNodes = _
        Me.CustomerNode.SelectNodes(element, prefix, True)
    MsgBox(nodes.Count & " element(s) were found.")
End Sub

Comentarios

Establecer el parámetro para false 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.