InsertXMLList()

Syntax

Ergebnis = InsertXMLList(ElternKnoten, Liste() [, VorherigerKnoten])

Fügt die angegebene Liste() 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.
Liste()	Die in die XML-Struktur einzufügende Liste.
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 "list" benannt und seine beinhalteten Element-Knoten werden als "element" bezeichnet. Siehe unten für ein Beispiel der erstellten XML-Struktur.

Beispiel

  ; Dieses Beispiel erzeugt folgende XML-Struktur:
  ;
  ; <list>
  ;   <element>square</element>
  ;   <element>circle</element>
  ;   <element>triangle</element>
  ; </list>
  ;
  NewList Shapes$()
  AddElement(Shapes$()): Shapes$() = "square"
  AddElement(Shapes$()): Shapes$() = "circle"
  AddElement(Shapes$()): Shapes$() = "triangle"

  If CreateXML(0)
    InsertXMLList(RootXMLNode(0), Shapes$())
    FormatXML(0, #PB_XML_ReFormat)
    Debug ComposeXML(0)
  EndIf

Beispiel

  ; Dieses Beispiel erzeugt folgende XML-Struktur:
  ;
  ; <list>
  ;   <element>
  ;     <x>100</x>
  ;     <y>200</y>
  ;   </element>
  ;   <element>
  ;     <x>200</x>
  ;     <y>400</y>
  ;   </element>
  ; </list>
  ;
  Structure Position
    x.l
    y.l
  EndStructure
  
  NewList Positions.Position()
  
  For i = 1 To 2
    AddElement(Positions())
    Positions()\x = 100 * i
    Positions()\y = 200 * i
  Next i

  If CreateXML(0)
    InsertXMLList(RootXMLNode(0), Positions())
    FormatXML(0, #PB_XML_ReFormat)
    Debug ComposeXML(0)
  EndIf

Siehe auch

ExtractXMLList(), InsertXMLArray(), InsertXMLMap(), InsertXMLStructure()

Unterstützte OS

Alle