Saltar para o conteúdo principal
Versão: 20 R7 BETA

DOM Find XML element by ID

DOM Find XML element by ID ( refElemento ; id ) -> Resultado

ParâmetroTipoDescrição
refElementoTextReferência de elemento XML
idTextValor do atributo ID do elemento a procurar
ResultadoTextReferência do elemento encontrado (se aplicável)

Descrição

O comando DOM Find XML element by ID busca, no interior de um documento XML, o elemento cujo atributo id seja igual ao valor passado no parâmetro id.

Passe em refElemento a referência de um elemento do documento XML no qual queira realizar a pesquisa. Pode passar a referência do elemento raiz ou de outro elemento, a pesquisa não considera a posição de refElemento e se realiza sempre na totalidade do documento.

O comando retorna como resultado a referência XML do elemento encontrado.

Aviso: Em XML, o atributo id associa um identificador único a cada elemento do documento. O valor do atributo id deve ser um nome XML válido e deve ser único no documento XML (restrição de validez). Para que o comando DOM Find XML element by ID funcione corretamente, esta restrição deve ser respeitada; do contrário o resultado será aleatório (o comando retorna a referência ao primeiro elemento encontrado no documento).

Ver também

DOM Find XML element