getElementsByTagName Method (DOMDocument)

9/8/2008

Retorna uma coleção de elementos que possuem o nome especificado.

Sintaxe de script

var objXMLDOMNodeList =
oXMLDOMDocument.getElementsByTagName(tagName);

Comentários

Parâmetros de script

• TagName
  A seqüência de caracteres que especifica o nome elemento para localizar. O TagName " * " Retorna todos os elementos de documento.

Valor Return script

Objeto. Aponta para uma coleção de elementos que corresponde ao nome especificado.

C/sintaxe C++

HRESULT getElementsByTagName(
  BSTR tagName,
  IXMLDOMNodeList** resultList
);

Comentários

C/parâmetros C++

• TagName
  [no] Nome do elemento para localizar. A nome_da_marca " * " Retorna todos os elementos de documento.

• resultList
  [out, retval] Endereço de uma coleção de elementos que corresponde ao nome especificado.

C/valores Return C++

• S_OK
  Valor retornado se bem-sucedido.

Requisitos

Header	msxml2.h, msxml2.idl
Library	uuid.lib
Windows Embedded CE	Windows CE .NET 4.0 and later

Comentários Gerais

Este método é válido somente se o recurso XML Query Language (XQL) foi incluído na sistema operacional (OS). Se um chamar para esse método é feita e XQL não é com suporte, uma mensagem de erro será retornada.

Os elementos a coleção são retornados na ordem na qual eles poderiam ser encontrados em um percurso predeterminado de árvore de documento. Em um percurso predeterminado, o nó raiz pai é visitado pela primeira vez e cada nó filho de esquerda para a direita, em seguida, é atravessada.

O retornado As IXMLDOMNodeList objeto é ao vivo e imediatamente reflete as alterações de nós que aparecem na lista.

Pesquisas mais complexas podem ser realizadas usando o Método SelectNodes. Esse método também pode ser mais rápido em alguns casos.

Este método se aplica ao seguinte objetos e interfaces:

DOMDocument e As IXMLDOMNodeList.

See Also

Concepts

selectNodes Method