DOM Find XML element by ID
DOM Find XML element by ID ( refElemento ; id ) : Text
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| refElemento | Text | → | Referência de elemento XML |
| id | Text | → | Valor do atributo ID do elemento a procurar |
| Resultado | Text | ← | Referê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
Propriedades
| Número do comando | 1010 |
| Thread-seguro | ✓ |
| Modificar variáveis | OK |