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

SAX OPEN XML ELEMENT ARRAYS

SAX OPEN XML ELEMENT ARRAYS ( documento ; etiqueta {; atribNomesArray ; attribValuesArray} {; atribNomesArray2 ; attribValuesArray2 ; ... ; atribNomesArrayN ; attribValuesArrayN} )

ParâmetroTipoDescrição
documentoTimeReferência do documento aberto
etiquetaTextNome do elemento a abrir
atribNomesArrayText arrayArray de nomes de atributo
attribValuesArrayText array, Integer array, Date array, Real array, Picture array, Boolean arrayArray of attribute values

Descrição

O comando SAX OPEN XML ELEMENT ARRAYS permite adicionar um novo elemento no documento XML cuja referência se passa em document como também, opcionalmente, atributos e seus valores em forma de arrays.

Exceto pela compatibilidade com arrays (ver a continuação), este comando es idêntico a SAX OPEN XML ELEMENT. Por favor consulte a descrição deste comando para maior informação sobre seu funcionamento.

SAX OPEN XML ELEMENT ARRAYS aceita arrays de tipo data, numéricos, booleanos e imagem como parâmetros arrayValoresAtrib. 4D automaticamente realiza todas as conversões necessárias; pode configurar estas conversões utilizando o comando XML SET OPTIONS.

Opcionalmente, o comando SAX OPEN XML ELEMENT ARRAYS permite passar pares de atributos e de valores de atributos em forma de arrays nos parâmetros arrayNomsAtrib e arrayValoresAtrib.

Os arrays devem ter sido criados previamente e funcionar em pares de valor atributo/atributo. Pode passar tantos pares de arrays e elementos em cada par quantos queira.

Exemplo

O método abaixo:

 ARRAY STRING(80;aNomsAtrib;2)
 ARRAY STRING(80;aValoresAtrib;2)
 vElement:="Livro"
 aNomsAtrib{1}:="Font"
 aValoresAtrib{1}:="Arial"
 aNomsAtrib{2}:="Style"
 aValoresAtrib{2}:="Bold"
 SAX OPEN XML ELEMENT ARRAYS($DocRef;vElemento;tNomsAtrib;tValoresAtrib)

... escreverá no documento:

<Book Font="Arial" Style="Bold">

Ver também

SAX CLOSE XML ELEMENT
SAX OPEN XML ELEMENT
XML SET OPTIONS

Propriedades

Número do comando921
Thread-seguro