InsertXMLMap()

Syntax

Ergebnis = InsertXMLMap(ElternKnoten, Map() [, VorherigerKnoten])

Fügt die angegebene Map() als einen neuen XML-Knoten in den angegebenen Elternknoten ein.

Parameter

ElternKnoten	Der Knoten, in welchen der neue Knoten eingefügt werden soll. Um den neuen Knoten an der Wurzel des XML-Baums einzufügen, kann hier RootXMLNode() verwendet werden.
Map()	Die in die XML-Struktur einzufügende Map.
VorherigerKnoten (optional)	Ein Unterknoten ("child") des 'ElternKnoten', nach dem der neue Knoten eingefügt werden soll. Ist dieser Wert gleich 0 oder nicht angegeben, dann wird der neue Knoten als erster Unterknoten seines Elternknotens eingefügt. Ist dieser Wert gleich -1, dann wird der neue Knoten als letzter Unterknoten seines Elternknotens eingefügt.

Rückgabewert

Der neue XML-Knoten, wenn er erfolgreich erstellt wurde - oder Null, wenn an dieser Stelle kein Knoten eingefügt werden konnte.

Anmerkungen

Die bei CreateXMLNode() angegebenen Regeln, wo ein neuer Knoten eingefügt werden kann, gelten auch für diese Funktion.

Der eingefügte Knoten wird "map" benannt und seine beinhalteten Element-Knoten werden als "element" bezeichnet. Jeder Element-Knoten wird ein als "key" bezeichnetes Attribut haben, welches den Map-Schlüssel (Key) des Elements beinhaltet. Siehe unten für ein Beispiel der erstellten XML-Struktur.

Beispiel

  ; Dieses Beispiel erzeugt folgende XML-Struktur:
  ;
  ; <map>
  ;   <element key="DE">Germany</element>
  ;   <element key="US">United States</element>
  ;   <element key="FR">France</element>
  ; </map>
  ;
  NewMap Countries.s()
  Countries("DE") = "Germany"
  Countries("FR") = "France"  
  Countries("US") = "United States"

  If CreateXML(0)
    InsertXMLMap(RootXMLNode(0), Countries())
    FormatXML(0, #PB_XML_ReFormat)
    Debug ComposeXML(0)
  EndIf

Siehe auch

ExtractXMLMap(), InsertXMLArray(), InsertXMLList(), InsertXMLStructure()

Unterstützte OS

Alle