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

Definição

Obtém um objeto XMLNode que representa o primeiro nó filho que corresponde ao parâmetro XPath no controle XMLNode.

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

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 PrefixMapping caso o parâmetro XPath use 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 é true.

Retornos

XMLNode

O primeiro nó filho que corresponde ao parâmetro XPath no controle XMLNode.

Exemplos

O exemplo de código a seguir usa o SelectSingleNode método para obter um nó filho que corresponde ao XPath parâmetro fornecido. Em seguida, o exemplo exibe o nome do nó que foi encontrado. Este exemplo pressupõe que o documento atual contém um XMLNode chamado CustomerNode com um elemento de esquema correspondente que contém um ou mais nós filho 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

Comentários

Definir o FastSearchSkippingTextNodes parâmetro para false diminui o desempenho porque 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