Método XMLNode.SelectSingleNode

Artigo
08/01/2011

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

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 seqüência de caracteres XPath válida.

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

FastSearchSkippingTextNodes
Tipo: System.Boolean
true para ignorar todos os nós de texto durante a pesquisa para o nó especificado.falsepara incluir nós de texto na pesquisa.Valor padrão é true.

Valor de retorno

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

Comentários

Definindo a FastSearchSkippingTextNodes parâmetro para false diminui o desempenho porque Microsoft Office o Word procura todos os nós em um documento para o texto contido no nó.

Optional Parameters

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

Exemplos

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

Partilhar via