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

Definición

Espacio de nombres:

Microsoft.Office.Tools.Word

Ensamblado:

Microsoft.Office.Tools.Word.dll

Obtiene un objeto XMLNode que representa el primer nodo secundario que coincide con el parámetro XPath en el control XMLNode.

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

abstract member SelectSingleNode : string * string * bool -> Microsoft.Office.Interop.Word.XMLNode

Public Function SelectSingleNode (XPath As String, Optional PrefixMapping As String = "", Optional FastSearchSkippingTextNodes As Boolean = true) As XMLNode

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 el PrefixMappingXPath 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 true.

Devoluciones

XMLNode

El primer nodo secundario que coincide con el parámetro XPath en el control XMLNode.

Ejemplos

En el ejemplo de código siguiente se usa el SelectSingleNode método para obtener un nodo secundario que coincida con el parámetro especificado XPath . A continuación, en el ejemplo se muestra 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 coincidente que contiene uno o varios nodos secundarios denominados LastName.

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.");
    }
}

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

Comentarios

Establecer el parámetro para false disminuir el FastSearchSkippingTextNodes 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 los parámetros opcionales, vea Parámetros opcionales en soluciones de Office.