DocumentBase.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 documento.
Espacio de nombres: Microsoft.Office.Tools.Word
Ensamblado: Microsoft.Office.Tools.Word.v4.0.Utilities (en Microsoft.Office.Tools.Word.v4.0.Utilities.dll)
Sintaxis
'Declaración
Public Function SelectNodes ( _
xPath As String, _
prefixMapping As String, _
fastSearchSkippingTextNodes As Boolean _
) As XMLNodes
public XMLNodes SelectNodes(
string xPath,
string prefixMapping,
bool fastSearchSkippingTextNodes
)
Parámetros
- xPath
Tipo: System.String
Cadena XPath válida.Para obtener más información sobre Xpath, vea Referencia de Xpath.
- prefixMapping
Tipo: System.String
Proporciona el prefijo del esquema que se va a utilizar para la búsqueda.Usa el parámetro PrefixMapping si el parámetro XPath emplea nombres para buscar elementos.
- fastSearchSkippingTextNodes
Tipo: System.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.
Valor devuelto
Tipo: Microsoft.Office.Interop.Word.XMLNodes
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 documento; nullreferencia null (Nothing en Visual Basic) si no se encuentra ningún nodo que coincida con el parámetro XPath.
Comentarios
Al establecer el parámetro FastSearchSkippingTextNodes en true 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 ejemplo de código siguiente se muestra cómo especificar los parámetros XPath y PrefixMapping al llamar al método SelectNodes. Para usar este ejemplo, ejecútelo desde la clase ThisDocument en un proyecto de nivel de documento.
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
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.");
}
}
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.