4D v13.4
DOM SET XML ELEMENT VALUE
- Manual de linguagem 4D
-
- XML DOM
-
- Visão Geral dos comandos XML DOM
- DOM Append XML child node
- DOM Append XML element
- DOM CLOSE XML
- DOM Count XML attributes
- DOM Count XML elements
- DOM Create XML element
- DOM Create XML element arrays
- DOM Create XML Ref
- DOM EXPORT TO FILE
- DOM EXPORT TO VAR
- DOM Find XML element
- DOM Find XML element by ID
- DOM Get first child XML element
- DOM Get last child XML element
- DOM Get next sibling XML element
- DOM Get parent XML element
- DOM Get previous sibling XML element
- DOM Get Root XML element
- DOM GET XML ATTRIBUTE BY INDEX
- DOM GET XML ATTRIBUTE BY NAME
- DOM GET XML CHILD NODES
- DOM Get XML document ref
- DOM Get XML element
- DOM GET XML ELEMENT NAME
- DOM GET XML ELEMENT VALUE
- DOM Get XML information
- DOM Insert XML element
- DOM Parse XML source
- DOM Parse XML variable
- DOM REMOVE XML ATTRIBUTE
- DOM REMOVE XML ELEMENT
- DOM SET XML ATTRIBUTE
- DOM SET XML ELEMENT NAME
- DOM SET XML ELEMENT VALUE
- DOM SET XML OPTIONS
DOM SET XML ELEMENT VALUE
| DOM SET XML ELEMENT VALUE ( refElemento {; xRota}; valorElemento {; *} ) | ||||||||
| Parâmetro | Tipo | Descrição | ||||||
| refElemento | cadeia |
|
Referência de elemento XML | |||||
| xRota | Texto |
|
Rota do xRota do elemento XML | |||||
| valorElemento | cadeia, Variável |
|
Novo valor do elemento | |||||
| * | Operador |
|
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.
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)
Produto: 4D
Tema: XML DOM
Número
868
Modificado: 4D 2004.4
Modificado: 4D v11 SQL
DOM GET XML ELEMENT VALUE
XML SET OPTIONS
