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

Referência

Definição

Namespace:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém uma coleção XMLNodes que representa todos os nós que correspondem ao parâmetro XPath na ordem em que são exibidos no controle XMLNode.

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

abstract member SelectNodes : string * string * bool -> Microsoft.Office.Interop.Word.XMLNodes

Public Function SelectNodes (XPath As String, Optional PrefixMapping As String = "", Optional FastSearchSkippingTextNodes As Boolean = true) As XMLNodes

Parâmetros

XPath: String

Uma cadeia de caracteres XPath válida.

PrefixMapping: String

Fornece o prefixo no esquema no qual a pesquisa deve ser realizada. Use o parâmetro se o PrefixMappingXPath parâmetro usar nomes para pesquisar elementos.

FastSearchSkippingTextNodes: Boolean

true para ignorar todos os nós de texto ao pesquisar o nó especificado. false para incluir nós de texto na pesquisa. O valor padrão é false.

Retornos

XMLNodes

Os nós que correspondem ao parâmetro XPath na ordem em que são exibidos no controle XMLNode.

Exemplos

O exemplo de código a seguir usa o SelectNodes método para obter uma coleção dos nós filho que correspondem ao parâmetro especificado XPath . Em seguida, o exemplo exibe o número de nós que foram encontrados. Este exemplo pressupõe que o documento atual contém um XMLNode nomeado CustomerNode com um elemento de esquema correspondente que contém um ou mais nós filho chamados FirstName.

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

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

Comentários

Definir o parâmetro como false diminui o FastSearchSkippingTextNodes desempenho, pois o Microsoft Office Word pesquisa todos os nós em um documento para o texto contido no nó.

Parâmetros Opcionais

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

Aplica-se a

Compartilhar via