4D v14.3

DOM SET XML ELEMENT VALUE

Página Inicial

 
4D v14.3
DOM SET XML ELEMENT VALUE

DOM SET XML ELEMENT VALUE 


 

DOM SET XML ELEMENT VALUE ( refElemento {; xRota}; valorElemento {; *} ) 
Parâmetro Tipo   Descrição
refElemento  cadeia in Referência de elemento XML
xRota  Texto in Rota do xRota do elemento XML
valorElemento  cadeia, Variável in Novo valor do elemento
Operador in Se passado: estabelece o valor em CDATA

O comando DOM SET XML ELEMENT VALUE lhe permite modificar o valor do elemento definido por refElement.

Se passar o parâmetro opcional xRota, você escolhe utilizar a notação XPath para indicar o elemento a ser modificado (para maior informação sobre esta notação, consulte o parágrafo “Uso da notação XPath” na seção Visão Geral dos comandos XML DOM). Neste caso, deve passar a referência de um elemento XML raiz em refElemento e a rota XPath do elemento a modificar em xRota.

Em valorElemento, passe uma cadeia ou uma variável (ou um campo) que contenha o novo valor do elemento especificado:

  •  Se passar uma cadeia, o valor se utilizará tal como na estrutura XML.
  •  Se passar uma variável ou um campo, 4D processará o valor, dependendo do tipo de valorElemento.
  •  Todos os tipos de dados podem ser utilizados, com exceção dos arrays, imagens e ponteiros.
Quando for passado o parâmetro opcional asterisco (*), indica que o valor do elemento deve ser definido na forma de CDATA. A forma especial CDATA permite escrever texto sem formato (ver exemplo 2).

Nota: Se o elemento designado por refElemento for de tipo BLOB, DOM SET XML ELEMENT VALUE o codifica automaticamente em banco64. Entretanto, o comando DOM GET XML ELEMENT VALUE realiza automaticamente a operação inversa.

Na fonte  XML abaixo:

<Book>
   <Title>O melhor vendedor</Title>
</Book>

Se for executado o código abaixo, com vRefElem conterá a referência do elemento “Título”:

 DOM SET XML ELEMENT VALUE(vRefElem;"O Perdedor")

Obtemos:

<Book>
   <Title>O Perdedor</Title>
</Book>

Na fonte XML abaixo:

<Maths>
   <Postulate>1+2=3</Postulate>
</Maths>

Queremos escrever o texto “12<18” no elemento <Postulate>. Esta cadeia não pode ser escrita em XML porque o caractere “<” não é aceito. Este caractere deve ser transformado então em “<” ou deve ser utilizado a forma CDATA. Se vElemRef indica o nodo XML <Postulate>:

  ` Forma normal
 DOM SET XML ELEMENT VALUE(vElemRef;"12<18")

Obtemos:

<Maths>
   <Postulate>12 < 18</Postulate>
</Maths>


  ` CDATA form
 DOM SET XML ELEMENT VALUE(vElemRef;"12<18";*)

Obtemos:

<Maths>
   <Postulate><![CDATA[12 < 18]]></Postulate>
</Maths>

Se o comando  tiver sido executado corretamente, a variável sistema Ok assume o valor 1. Se ocorrer um erro, assume o valor 0 e um erro é gerado (por exemplo, se a referência do elemento for inválida)

 
PROPRIEDADES 

Produto: 4D
Tema: XML DOM
Número 868

Este comando modifica a variável sistema OKEste comando modifica a variável sistema Error

 
HISTÓRIA 

Modificado: 4D 2004.4
Modificado: 4D v11 SQL

 
VER TAMBÉM 

DOM GET XML ELEMENT VALUE
XML SET OPTIONS

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)