XMLNode.SelectSingleNode(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 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);

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

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 é 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 corresponda ao parâmetro especificado XPath . Em seguida, o exemplo exibe o nome do nó que foi encontrado. 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 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 parâmetro como false diminui o FastSearchSkippingTextNodes desempenho porque 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