Método Document. SelectSingleNode (Word)Document.SelectSingleNode method (Word)

Retorna um objeto XMLNode que representa o primeiro nó que corresponde ao parâmetro XPath no documento especificado.Returns an XMLNode object that represents the first node that matches the XPath parameter in the specified document.

SintaxeSyntax

expression.expression. SelectSingleNode( _XPath_ , _PrefixMapping_ , _FastSearchSkippingTextNodes_ )

expressão Obrigatório.expression Required. Uma variável que representa um objeto Document.A variable that represents a Document object.

ParâmetrosParameters

NomeName Obrigatório/OpcionalRequired/Optional Tipo de dadosData type DescriçãoDescription
XPathXPath ObrigatórioRequired StringString Uma sequência de caminho XPath válida.A valid XPath string. Para obter mais informações sobre o XPath, consulte a documentação de referência do XPath no Web site Microsoft Developer Network (MSDN).For more information on XPath, see the XPath reference documentation on the Microsoft Developer Network (MSDN) Web site.
PrefixMappingPrefixMapping OpcionalOptional VariantVariant Fornece o prefixo no esquema no qual será realizada a busca.Provides the prefix in the schema against which to perform the search. Use o parâmetro PrefixMapping se o seu parâmetro XPath usar nomes para busca de elementos.Use the PrefixMapping parameter if your XPath parameter uses names to search for elements.
Como FastSearchSkippingTextNodesFastSearchSkippingTextNodes OpcionalOptional BooleanBoolean True ignora todos os nós de texto ao procurar o nó especificado.True skips all text nodes while searching for the specified node. False inclui nós de texto na pesquisa.False includes text nodes in the search. Valor padrão é True.Default value is True.

Valor de retornoReturn value

XMLNodeXMLNode

ComentáriosRemarks

A definição do parâmetro como FastSearchSkippingTextNodes como false diminui o desempenho porque o Microsoft Word pesquisa todos os nós em um documento em relação ao texto contido no nó.Setting the FastSearchSkippingTextNodes parameter to False diminishes performance because Microsoft Word searches all nodes in a document against the text contained in the node.

ExemploExample

O exemplo a seguir retorna o primeiro elemento título identificado no documento ativo o qual é um elemento filho no elemento livro.The following example returns the first title element found in the active document that is a child element of the book element.

Dim objElement As XMLNode 
Dim strElement As String 
Dim strPrefix As String 
 
strElement = "/x:catalog/x:book/x:title" 
strPrefix = "xmlns:x=""" & ActiveDocument _ 
 .XMLSchemaReferences(1).NamespaceURI & """" 
 
Set objElement = ActiveDocument _ 
 .SelectSingleNode(strElement, strPrefix)

Confira tambémSee also

Objeto DocumentDocument Object

Suporte e comentáriosSupport and feedback

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação?Have questions or feedback about Office VBA or this documentation? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.