4D v16.3
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 elementsUpd
- 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 NAME
- DOM GET XML ELEMENT VALUE
- DOM Get XML elementUpd
- 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 DECLARATIONS
- DOM SET XML ELEMENT NAME
- DOM SET XML ELEMENT VALUE
DOM SET XML ELEMENT VALUE
| DOM SET XML ELEMENT VALUE ( refElemento {; xRota}; valorElemento {; *} ) | ||||||||
| Parâmetro | Tipo | Descrição | ||||||
| refElemento | String |
|
Referência de elemento XML | |||||
| xRota | Texto |
|
Rota do xRota do elemento XML | |||||
| valorElemento | String, 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.
Par conformité avec les règles de traitement XML, toutes les séquences de caractères de fin de ligne CR et CRLF sont converties en caractères LF.
Para conformidade com as regras XML, todas as sequências de caracteres de final de linha CR e CRLF são convertidas para caracteres LF.
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
Manual de linguagem 4D ( 4D v16)
Manual de linguagem 4D ( 4D v16.1)
Manual de linguagem 4D ( 4D v16.2)
Manual de linguagem 4D ( 4D v16.3)
