Método XMLNode.SelectNodes

Artigo
05/21/2013

Obtém uma coleção de Microsoft.Office.Interop.Word.XMLNodes que representa todos os nós que correspondem ao parâmetro de XPath na ordem em que aparecem 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 SelectNodes ( _
    XPath As String, _
    PrefixMapping As String, _
    FastSearchSkippingTextNodes As Boolean _
) As XMLNodes

XMLNodes SelectNodes(
    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 é false.

Valor de retorno

Tipo: Microsoft.Office.Interop.Word.XMLNodes
Os nós que correspondem ao parâmetro de XPath na ordem em que aparecem no controle de Microsoft.Office.Tools.Word.XMLNode .

Comentários

Defina o parâmetro de FastSearchSkippingTextNodes a false reduz o desempenho, como 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 SelectNodes para obter uma coleção de nós filho que correspondem ao parâmetro dado de XPath .O exemplo exibe o número de nós que foram encontrados.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 FirstName.

Private Sub DisplayFirstNameNodesCount()
    Dim element As String = "/x:Customer/x:FirstName"
    Dim prefix As String = "xmlns:x='" & _
        Me.CustomerFirstNameNode.NamespaceURI & "'"

    Dim nodes As Word.XMLNodes = _
        Me.CustomerNode.SelectNodes(element, prefix, True)
    MsgBox(nodes.Count & " element(s) were found.")
End Sub

private void DisplayFirstNameNodesCount()
{
    string element = "/x:Customer/x:FirstName";
    string prefix = "xmlns:x='" + 
        this.CustomerFirstNameNode.NamespaceURI + "'";

    Word.XMLNodes nodes = this.CustomerNode.SelectNodes(element, 
        prefix, true);
    MessageBox.Show(nodes.Count + " element(s) were 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