Zum Hauptinhalt springen

XmlWrite

obj -> XmlWrite(int1[, alpha2[, alpha3[, alpha4[, alpha5[, alpha6]]]]]) : int​

Ausführbar von Clients mit grafischer Oberfläche Ausführbar vom Server Ausführbar von Clients mit Programmierschnittstelle Ausführbar von der Web-Schnittstelle Ausführbar vom Druckprozessor Ausführbar von der ODBC-Schnittstelle Ausführbar vom SOA-Service

Schreibt einen Knoten einer XML-Datei

Details

  • obj: Deskriptor des XmlWriter-Objektes
  • int1:
    • Typ:
    • _XmlStartDocument
    • _XmlEndDocument
    • _XmlStartElement
    • _XmlEndElement
    • _XmlWriteElement
    • _XmlWriteAttribute
    • _XmlWriteDocType
    • _XmlWritePI
    • _XmlWriteText
    • _XmlWriteCDATA
    • _XmlWriteComment
  • alpha2: Argument1 (optional)
  • alpha3: Argument2 (optional)
  • alpha4: Argument3 (optional)
  • alpha5: Argument4 (optional)
  • alpha6: Argument5 (optional)
  • Resultat: int Fehlercode _ErrOk Kein Fehler aufgetreten _ErrGeneric Fehler aufgetreten Anweisung setzt den globalen Fehlerwert
  • Siehe: Verwandte Befehle , XmlOpenWriter ()

Dieser Befehl schreibt einen Knoten in die XML-Datei (obj). Der Inhalt wird vor dem Schreiben gepuffert. Wird die Größe des Puffers überschritten oder XmlWrite ( _XmlEndDocument ) aufgerufen, wird der Pufferinhalt in die Datei geschrieben. Je nach Typ (int1) müssen die Argumente Argument1 (alpha2) bis Argument5 (alpha6) angegeben werden. Folgende Konstanten können als Typ (int1) angegeben werden:

  • Typ: Beschreibung
  • _XmlStartDocument ( 1 ): Start des XML-Dokumentes Argument1 Version Argument2 Zeichensatzkodierung Argument3 Standalone-Flag
  • _XmlEndDocument ( 2 ): Ende des XML-Dokumentes Keine Argumente benötigt Alle offenen Knoten werden geschlossen.
  • _XmlStartElement ( 3 ): Neues Element öffnen Argument1 Name
  • _XmlEndElement ( 4 ): Element schließen Keine Argumente benötigt
  • _XmlWriteElement ( 5 ): Neues Element einfügen Argument1 Name Argument2 Inhalt Das Element kann keine Kindelemente oder Attribute enthalten.
  • _XmlWriteAttribute ( 6 ): Attribut schreiben Argument1 Name Argument2 Wert
  • _XmlWriteDocType ( 7 ): DTD-Verweis einfügen Argument1 Name Argument2 Speicherort einer Public-DTD Argument3 Speicherort einer System-DTD
  • _XmlWritePI ( 8 ): Verarbeitungsanweisung einfügen Argument1 Ziel Argument2 Inhalt
  • _XmlWriteText ( 9 ): Text einfügen Argument1 Text
  • _XmlWriteCDATA ( 10 ): Daten einfügen Argument1 Daten
  • _XmlWriteComment ( 11 ): Kommentar einfügen Argument1 Kommentar
info

Die Zeichenketten werden im CONZEPT 16-Zeichensatz erwartet. Die Ausgabe erfolgt in der _XmlStartDocument unter Zeichensatzkodierung angegebenen Kodierung.

Wurde der Knoten erfolgreich geschrieben, wird _ErrOk zurückgegeben, andernfalls _ErrGeneric.

Beispiel:

// XmlWriter öffnen
tXmlWriter # XmlOpenWriter('C:\XML.xml', _XmlOpenWriterDefault);
if (tXmlWriter > 0)
{
  // Kopf und Wurzelknoten schreiben
  tXmlWriter->XmlWrite(_XmlStartDocument, '1.0', 'UTF-8', 'no');
    tXmlWriter->XmlWrite(_XmlWriteDocType, 'Customers', '/customers.dtd', '');
    tXmlWriter->XmlWrite(_XmlWritePI, 'xml-stylesheet', 'type="text/xsl" href="/customers.xsl"');
      tXmlWriter->XmlWrite(_XmlStartElement, 'customers');

        tXmlWriter->XmlWrite(_XmlWriteComment, 'Kunde 1');
        tXmlWriter->XmlWrite(_XmlStartElement, 'customer', '');
          tXmlWriter->XmlWrite(_XmlWriteAttribute, 'number', '1');
        tXmlWriter->XmlWrite(_XmlEndElement);

        tXmlWriter->XmlWrite(_XmlWriteComment, 'Kunde 42');
        tXmlWriter->XmlWrite(_XmlStartElement, 'customer');
          tXmlWriter->XmlWrite(_XmlWriteAttribute, 'number', '42');
          tXmlWriter->XmlWrite(_XmlWriteElement, 'contact', 'Mrs. Miller');
          tXmlWriter->XmlWrite(_XmlWriteElement, 'contact', 'Mr. Smith');
        tXmlWriter->XmlWrite(_XmlEndElement);

        tXmlWriter->XmlWrite(_XmlWriteComment, 'Kunde 4711');
        tXmlWriter->XmlWrite(_XmlStartElement, 'customer');
          tXmlWriter->XmlWrite(_XmlWriteAttribute, 'number', '4711');
          tXmlWriter->XmlWrite(_XmlWriteElement, 'contact', 'Mrs. Jones');
          tXmlWriter->XmlWrite(_XmlWriteElement, 'contact', 'Mr. Thompson');

  // Alle offenen Ebenen schließen
  tXmlWriter->XmlWrite(_XmlEndDocument);

  // XmlWriter schließen
  tXmlWriter->XmlClose();
}

Mögliche Laufzeitfehler:

  • _ErrHdlInvalid: Der Deskriptor (obj) ist kein gültiger XmlWriter-Deskriptor.
  • _ErrValueInvalid: Der angegebene Typ (int1) ist ungültig.
  • _ErrNoArgument: Mindestens eines der benötigten Argumente (alpha2 - alpha6) fehlt.