Método XMLNode.SelectSingleNode

Artigo
05/21/2013

Obtém um objeto de Microsoft.Office.Interop.Word.XMLNode que representa o primeiro nó filho que corresponde ao parâmetro de XPath no controle de Microsoft.Office.Tools.Word.XMLNode .

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (em Microsoft.Office.Tools.Word.dll)

Sintaxe

'Declaração
Function SelectSingleNode ( _
    XPath As String, _
    PrefixMapping As String, _
    FastSearchSkippingTextNodes As Boolean _
) As XMLNode

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

Parâmetros

XPath
Tipo: System.String
Uma cadeia de caracteres XPath válida em.

PrefixMapping
Tipo: System.String
Fornece o prefixo no esquema para executar contra que a pesquisa.Use o parâmetro de PrefixMapping se o parâmetro de XPath usa nomes para procurar elementos.

FastSearchSkippingTextNodes
Tipo: System.Boolean
true para ignorar todos os nós de texto ao procurar pelo nó especificado. false para incluir nós de texto na pesquisa.O valor padrão é true.

Valor de retorno

Tipo: Microsoft.Office.Interop.Word.XMLNode
O primeiro nó filho que corresponde ao parâmetro de XPath no controle de Microsoft.Office.Tools.Word.XMLNode .

Comentários

Defina o parâmetro de FastSearchSkippingTextNodes a false reduz o desempenho porque o Microsoft Office Word pesquisam todos os nós em um documento pelo texto contido no nó.

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código a seguir usa o método de SelectSingleNode para obter um nó filho que corresponde ao parâmetro dado de XPath .O exemplo exibe o nome do nó que foi encontrado.Este exemplo assume que o documento atual contiver XMLNode chamado CustomerNode com um elemento correspondente de esquema que contém um ou mais nós filho chamados 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.");
    }
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

XMLNode Interface

Namespace Microsoft.Office.Tools.Word

Compartilhar via