Método DocumentBase.SelectSingleNode

Artigo
08/01/2011

Retorna um Microsoft.Office.Interop.Word.XMLNode o objeto que representa o primeiro nó no documento que corresponde a XPath parâmetro.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word.v4.0.Utilities (em Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Sintaxe

'Declaração
Public Function SelectSingleNode ( _
    xPath As String, _
    prefixMapping As String, _
    fastSearchSkippingTextNodes As Boolean _
) As XMLNode

public XMLNode SelectSingleNode(
    string xPath,
    string prefixMapping,
    bool fastSearchSkippingTextNodes
)

Parâmetros

xPath
Tipo: System.String
Uma seqüência de caracteres XPath válida.Para obter mais informações sobre o XPath, consulte Referência de XPath.

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 ignora todos os nós de texto durante a pesquisa para o nó especificado.falseinclui nós de texto na pesquisa.Valor padrão é false.

Valor de retorno

Tipo: Microsoft.Office.Interop.Word.XMLNode
A Microsoft.Office.Interop.Word.XMLNode o objeto que representa o primeiro nó que corresponde a XPath parâmetro no documento; nulluma referência nula (Nothing no Visual Basic)se nós que correspondem a XPath parâmetro são encontrados.

Comentários

Definindo a FastSearchSkippingTextNodes parâmetro para true diminui o desempenho porque Microsoft Office o Word procura todos os nós em um documento 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 exemplo de código a seguir demonstra como especificar o XPath e PrefixMapping parâmetros ao chamar o SelectSingleNode método. Para usar esse exemplo, executá-lo do ThisDocument a classe em um projeto de nível de documento.

Private Sub DocumentSelectSingleNode()
    If Me.XMLSchemaReferences.Count > 0 Then
        Dim XPath As String = "/x:catalog/x:book/x:title"
        Dim PrefixMapping As String = "xmlns:x=""" + _
            Me.XMLSchemaReferences(1).NamespaceURI + """"
        Dim node As Word.XMLNode = Me.SelectSingleNode(XPath, _
            PrefixMapping, True)
    Else
        MessageBox.Show("The document does not contain a " + _
            "schema reference.")
    End If
End Sub

private void DocumentSelectSingleNode()
{
    if (this.XMLSchemaReferences.Count > 0)
    {
        string XPath = "/x:catalog/x:book/x:title";
        object key = 1;

        string PrefixMapping = "xmlns:x=\"" +
            this.XMLSchemaReferences.get_Item(ref key).NamespaceURI +
            "\"";

        Word.XMLNode node = this.SelectSingleNode(XPath, 
            PrefixMapping, true);
    }
    else
    {
        MessageBox.Show("The document does not contain a " +
            "schema reference.");
    }
}

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

DocumentBase Classe

Namespace Microsoft.Office.Tools.Word

Compartilhar via