SAX OPEN XML ELEMENT ARRAYS

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

Parâmetro	Tipo		Descrição
documento	Time	→	Referência do documento aberto
etiqueta	Text	→	Nome do elemento a abrir
atribNomesArray	Text array	→	Array de nomes de atributo
attribValuesArray	Text array, Integer array, Date array, Real array, Picture array, Boolean array	→	Array of attribute values

Descriçã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 comando	921
Thread-seguro	✓