DocumentBase.SelectSingleNode (Método)
Devuelve un objeto Microsoft.Office.Interop.Word.XMLNode que representa el primer nodo del documento que se corresponde con el parámetro XPath.
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 SelectSingleNode ( _
xPath As String, _
prefixMapping As String, _
fastSearchSkippingTextNodes As Boolean _
) As XMLNode
public XMLNode SelectSingleNode(
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.XMLNode
Un objeto Microsoft.Office.Interop.Word.XMLNode que representa el primer nodo que coincide con el parámetro XPath en el documento; nullreferencia null (Nothing en Visual Basic) si no se encuentra ningún nodo que coincida con el parámetro XPath.
Comentarios
Si el parámetro FastSearchSkippingTextNodes se establece en true, el rendimiento disminuye porque Microsoft Office Word busca el texto contenido en el nodo en todos los nodos de un documento.
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 SelectSingleNode.Para usar este ejemplo, ejecútelo desde la clase ThisDocument en un proyecto de nivel de documento.
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
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.");
}
}
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.