SAX GET XML ELEMENT

SAX GET XML ELEMENT ( documento : Time ; nome : Text ; prefixo : Text ; nomesAtributos : Text array ; valoresAtributos : Text array )

Parâmetro	Tipo		Descrição
documento	Time	→	Referência do documento aberto
nome	Text	←	Element name
prefixo	Text	←	Namespace
nomesAtributos	Text array	←	Attribute names
valoresAtributos	Text array	←	Attribute values

Histórico

Versão	Alterações
2004	Criado por

Descrição

O comando SAX GET XML ELEMENT devolve diversa informação relativa ao elemento nome presente no documento XML referenciado por documento. Este comando deve ser chamado com os eventos XML Start Element ou XML End Element SAX. No caso específico de XML End Element, os parâmetros de atributos não são manipulados. Para maior informação sobre os eventos SAX, consulte a descrição do comando SAX Get XML node.

O parâmetro nome contém o nome do elemento.

O parâmetro prefixo devolve o espaço de nome (namespace) do elemento. Este parâmetro está vazio se nenhum espaço de nome estiver associado ao elemento.

O comando preenche o array nomsAtributos com os nomes dos atributos do elemento objetivo. Se for necessário, o comando cria e dimensiona automaticamente o array.

O comando também preenche o array valoresAtributos com os valores dos atributos do elemento objetivo. Se for necessário, o comando cria e dimensiona automaticamente o array.

Exemplo

Consideremos o código XML abaixo:

 
 MeuTexto
 

Quando executar a seguinte instrução:

 SAX GET XML ELEMENT(DocRef;vNome;vPrefixo;tAttrNomes;tAttrValores)

...vNome conterá “Filho”
vPrefix conterá “”
tAttrNomes{1} conterá “Att1”, tAttrNomes{2} conterá “Att2”, tAttrNomes{3} conterá “Att3”
tAttrValores{1} conterá “111”, tAttrValores{2} conterá “222”, tAttrValores{3} conterá “333”

Variáveis e conjuntos do sistema

Se o comando tiver sido executado corretamente, a variável sistema Ok assume o valor 1. Do contrário, assume o valor e se gera um erro.

Ver também

SAX Get XML node

Propriedades

Número do comando	876
Thread-seguro	yes
Modificar variáveis	OK