XMLNode.SelectSingleNode (Método)

Obtiene un objeto Microsoft.Office.Interop.Word.XMLNode que representa el primer nodo secundario que coincide con el parámetro XPath 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 SelectSingleNode ( _
    XPath As String, _
    PrefixMapping As String, _
    FastSearchSkippingTextNodes As Boolean _
) As XMLNode

XMLNode SelectSingleNode(
    string XPath,
    string PrefixMapping,
    bool FastSearchSkippingTextNodes
)

Parámetros

  • 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 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 true.

Valor devuelto

Tipo: Microsoft.Office.Interop.Word.XMLNode
El primer nodo secundario que coincide con el parámetro XPath 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 ejemplo de código se utiliza el método SelectSingleNode para obtener un nodo secundario que coincida con el parámetro XPath determinado.En el ejemplo se mostrará el nombre del nodo que se encontró.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 LastName.

Private Sub FindLastNameNode()
    Dim element As String = "/x:Customer/x:LastName"
    Dim prefix As String = "xmlns:x='" & _
        Me.CustomerLastNameNode.NamespaceURI & "'"

    Dim node As Word.XMLNode = _
        Me.CustomerNode.SelectSingleNode(element, prefix, True)
    If node IsNot Nothing Then
        MsgBox(node.BaseName & " element was found.")
    Else
        MsgBox("The requested node was not found.")
    End If
End Sub

private void FindLastNameNode()
{
    string element = "/x:Customer/x:LastName";
    string prefix = "xmlns:x='" + 
        this.CustomerLastNameNode.NamespaceURI + "'";

    Word.XMLNode node = this.CustomerNode.SelectSingleNode(element,
        prefix, true);
    if (node != null)
    {
        MessageBox.Show(node.BaseName + " element was found.");
    }
    else
    {
        MessageBox.Show("The requested node was not found.");
    }
}

Seguridad de .NET Framework

Vea también

Referencia

XMLNode Interfaz

Microsoft.Office.Tools.Word (Espacio de nombres)

  • Last updated on