4D v16.3
DOM SET XML ELEMENT VALUE
- 4D Programmiersprache
-
- XML DOM
-
- Überblick über XML DOM Befehle
- 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 DECLARATION
- DOM SET XML ELEMENT NAME
- DOM SET XML ELEMENT VALUE
DOM SET XML ELEMENT VALUE
| DOM SET XML ELEMENT VALUE ( ElementRef {; xPath}; ElementWert {; *} ) | ||||||||
| Parameter | Typ | Beschreibung | ||||||
| ElementRef | String |
|
Referenz auf XML Element | |||||
| xPath | Text |
|
Pfad xPath des XML Elements | |||||
| ElementWert | String, Variable |
|
Neuer Wert des Elements | |||||
| * | Operator |
|
Mit Stern: Setze Wert in CDATA | |||||
Der Befehl DOM SET XML ELEMENT VALUE ändert den Wert des Elements, definiert durch ElementRef.
Mit den optionalen Parameter xPath legen Sie fest, dass auf das zu ändernde Element über die Notation XPath (siehe Absatz XPath Notation verwalten (DOM)) zugegriffen wird. In diesem Fall müssen Sie in ElementWert die Referenz auf ein Root XML Element übergeben und in xPath den Pfad XPath des zu ändernden Elements.
In ElementRef übergeben Sie die Referenz auf das zu ändernde Element, in ElementWert den neuen Wert:
- Übergeben Sie einen String, wird der Wert wie gehabt in der XML Struktur verwendet.
- Übergeben Sie eine Variable oder ein Feld, bearbeitet 4D den Wert je nach Typ von ElementWert. Sie können bis auf Arrays, Bilder und Zeiger alle Datentypen verwenden.
Ist der optionale Parameter Stern (*) übergeben, muss der Wert des Elements im Format CDATA gesetzt werden. In diesem Sonderformat lässt sich Ausgangstext unverändert schreiben (siehe Beispiel 2).
Hinweis: Ist in diesem Befehl das in ElementRef übergebene Element ein BLOB, wird es automatisch in base64 codiert. In diesem Fall führt der Befehl DOM SET XML ELEMENT VALUE automatisch die umgekehrte Operation aus.
In Anlehnung an die Regeln zum Bearbeiten von XML werden alle Zeichen für Zeilenende (CR und CRLF) in LF Zeichen konvertiert.
Wird in dieser XML Quelle:
<Book> <Title>The Best Seller</Title> </Book>
…der nachfolgende Code ausgeführt, wobei vElementRef die Referenz auf das Element ‘Title’ enthält:
DOM SET XML ELEMENT VALUE(vElemRef;"The Loser")…erhalten Sie:
<Book> <Title>The Loser</Title> </Book>
Wir gehen von folgender XML Struktur aus:
<Maths> <Postulate>1+2=3</Postulate> </Maths>
Wir wollen in der XML Struktur den Text “12 < 18” im Element <Postulate> schreiben. Dieser String lässt sich in dieser Form nicht in XML schreiben, da das Zeichen “<” nicht akzeptiert wird. Es muss geändert werden in “<” oder das Format CDATA muss verwendet werden.Gibt vElemRef den XML-Knoten <Postulate> an, gilt folgendes:
` Normales Formular
DOM SET XML ELEMENT VALUE(vRefElem;"12 < 18")Wir erhalten:
<Maths> <Postulate>12 < 18</Postulate> </Maths>
` Format CDATA
DOM SET XML ELEMENT VALUE(vRefElem;"12 < 18";*)Wir erhalten:
<Maths> <Postulate><![CDATA[12 < 18]]></Postulate> </Maths>
Bei korrekt ausgeführtem Befehl wird die Systemvariable OK auf 1 gesetzt, sonst auf 0 (Null) und ein Fehler wird zurückgegeben; z.B. bei ungültiger Referenz auf das Element.
Produkt: 4D
Thema: XML DOM
Nummer:
868
Geändert: 4D 2004.4
Geändert: 4D v11 SQL
4D Programmiersprache ( 4D v16)
4D Programmiersprache ( 4D v16.1)
4D Programmiersprache ( 4D v16.2)
4D Programmiersprache ( 4D v16.3)
