XMLNode.SelectNodes (Método)
Obtiene una colección Microsoft.Office.Interop.Word.XMLNodes que representa todos los nodos que coinciden con el parámetro XPath en el orden en que aparecen en el control Microsoft.Office.Tools.Word.XMLNode.
Espacio de nombres: Microsoft.Office.Tools.Word
Ensamblado: Microsoft.Office.Tools.Word (en Microsoft.Office.Tools.Word.dll)
Sintaxis
'Declaración
Function SelectNodes ( _
XPath As String, _
PrefixMapping As String, _
FastSearchSkippingTextNodes As Boolean _
) As XMLNodes
XMLNodes SelectNodes(
string XPath,
string PrefixMapping,
bool FastSearchSkippingTextNodes
)
Parámetros
- XPath
Tipo: System.String
Cadena XPath válida.
- PrefixMapping
Tipo: System.String
Proporciona el prefijo del esquema que se va a utilizar para la búsqueda.Use el parámetro PrefixMapping si el parámetro XPath emplea nombres para buscar elementos.
- FastSearchSkippingTextNodes
Tipo: System.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.
Valor devuelto
Tipo: Microsoft.Office.Interop.Word.XMLNodes
Los nodos que coinciden con el parámetro XPath en el orden en que aparecen en el control Microsoft.Office.Tools.Word.XMLNode.
Comentarios
Al establecer el parámetro FastSearchSkippingTextNodes en false se reduce el 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 parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.
Ejemplos
En el siguiente código de ejemplo se utiliza el método SelectNodes para obtener una colección de los nodos secundarios que coinciden con el parámetro XPath determinado. En el ejemplo se mostrará 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 correspondiente que contiene uno o más nodos secundarios con el nombre FirstName.
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
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.");
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.