XmlRead

obj -> XmlRead([int1]]) : int

Liest den nächsten Knoten einer XML-Datei

Details

• obj: Deskriptor des XmlReader-Objektes
• int1:
  • Optionen (optional):
  • _XmlReadAttribNode
• Resultat: int Leseresultat: _ErrOk Nächster Knoten gelesen _ErrEndOfData Kein nächster Knoten vorhanden _ErrGeneric Fehler bei der Verarbeitung
• Siehe: Verwandte Befehle , XmlOpenReader () , XmlGetValueInt () , XmlGetValueAlpha ()

Dieser Befehl liest den nächsten Knoten in der XML-Datei (obj). Wird als Option (int1) _XmlReadAttribNode angegeben, wird von dem Knoten ein Attributknoten gelesen. Andernfalls wird ein normaler Knoten gelesen.

Als Resultat wird ein Fehlerwert zurückgegeben. Folgende Fehlerwerte können zurückgegeben werden:

• _ErrOk: Nächster Knoten wurde erfolgreich gelesen.
• _ErrEndOfData: Es gibt keinen folgenden Hauptknoten oder der Knoten hat keinen Attributknoten (bei Option (int1) = _XmlReadAttribNode ).
• _ErrGeneric: Bei der Verarbeitung ist ein Fehler aufgetreten.

Beispiel:

// XmlReader öffnen
tXmlReader # XmlOpenReader('C:\File.xml', 'C:\Schema.xml');
if (tXmlReader > 0)
{
  // Alle Knoten der XML-Datei durchgehen
  while (tXmlReader->XmlRead() = _ErrOk)
  {
    // Knoten verarbeiten
    // ...

    // Attribute des Knotens durchgehen
    tAttribCount # tXmlReader->XmlGetValueInt(_XmlGetAttribCount);
    if (tAttribCount > 0)
    {
      // Alle Attributknoten des aktuellen Knotens durchgehen
      do
      {
        tXmlReader->XmlRead(_XmlReadAttribNode);
        // Attributknoten verarbeiten
        // ...

        Dec(tAttribCount);
      }
      while (tAttribCount > 0);
    }
  }

  // XmlReader schließen
  tXmlReader->XmlClose();
}

Mögliche Laufzeitfehler:

• _ErrHdlInvalid: Der Deskriptor (obj) ist kein gültiger XmlReader-Deskriptor.
• _ErrValueInvalid: Die angegebene Option (int1) ist ungültig.