Saltar para o conteúdo principal
Versão: Próximo

SAX OPEN XML ELEMENT

SAX OPEN XML ELEMENT ( documento ; etiqueta {; nomeAtrib ; valorAtributo} {; nomeAtrib2 ; valorAtributo2 ; ... ; nomeAtribN ; valorAtributoN} )

ParâmetroTipoDescrição
documentoTimeReferência do documento aberto
etiquetaTextNome do elemento a abrir
nomeAtribTextNome de atributo
valorAtributoTextValor do atributo

Descrição

O comando SAX OPEN XML ELEMENT permite adicionar um novo elemento no documento XML referenciado por documento, assim como, opcionalmente, atributos e seus valores.

O elemento adicionado está “aberto” no documento (a etiqueta de final não foi adicionada). Para fechar um elemento criado utilizando este comando, deve:

  • Utilizar o comando SAX CLOSE XML ELEMENT, ou
  • Fechar o documento XML. Neste caso, 4D adicionará automaticamente as etiquetas XML de fechamento necessárias. Em etiqueta, passe o nome do elemento a criar. Este nome apenas pode conter letras, números e os caracteres “.”, “-“,”_” e “:”. Se for passado um caractere inválido em etiqueta, se gerará um erro.

Opcionalmente, o comando permite passar um ou vários pares de atributos/valores (em forma de variáveis, campos ou valores literais) utilizando os parâmetros nomeAtributo e valorAtributo. Pode passar tantos pares atributo/valor como queira.

Exemplo

A seguinte instrução:

 vElement:="Livro"
 SAX OPEN XML ELEMENT($DocRef;vElement)

... escreverá a linha abaixo no documento:

 <book< pre=""></book<>

Gestão de erros

Se passar em tag um caractere inválido, se gera um erro.

Ver também

SAX CLOSE XML ELEMENT
SAX OPEN XML ELEMENT ARRAYS

Propriedades

Número do comando853
Thread-seguro
Modificar variáveiserror