@XMLElement

Die komplexe Eigenschaft '@XMLElement' wird in einem Datensatzfeld angegeben und identifiziert die Merkmale eines XML-Elements. Die Eigenschaft umfasst die folgenden Felder:
name
Der Name des XML-Elements. Der Standardwert ist der Name des Datensatzfelds.

Wenn Sie einen Datensatz in eine XML-Zeichenfolge schreiben, wird der Wert des Eigenschaftsfelds dem Element in der XML-Zeichenfolge zugeordnet. Wenn Sie eine XML-Zeichenfolge in einen Datensatz lesen, gibt die EGL-Laufzeit eine Laufzeitausnahmebedingung (RuntimeException) aus, wenn der Name des XML-Elements auf der höchsten Ebene nicht mit dem Wert des Eigenschaftsfelds übereinstimmt.

namespace
Der XML-Namensbereich (sofern vorhanden), der dem XML-Element zugeordnet ist. Sie müssen den Namensbereich explizit angeben, und zwar selbst dann, wenn es sich um einen Standardnamensbereich handelt.
Wenn Sie einen Namensbereich angeben, gilt Folgendes:
  • Wenn Sie einen Datensatz in eine XML-Zeichenfolge schreiben, wird automatisch ein Namensbereichspräfix zugeordnet.
  • Wenn Sie eine XML-Zeichenfolge in einen Datensatz lesen, tritt eine Ausnahmebedingung vom Typ 'XMLProcessingException' auf, wenn sich das Element nicht im angegebenen Namensbereich befindet.
Wenn Sie keinen Namensbereich angeben, gilt Folgendes:
  • Wenn Sie einen Datensatz in eine XML-Zeichenfolge schreiben, wird kein Namensbereichspräfix angegeben.
  • Wenn Sie eine XML-Zeichenfolge in einen Datensatz lesen, tritt eine Ausnahmebedingung vom Typ 'XMLProcessingException' auf, wenn sich das Element in einem Namensbereich befindet.
nillable
Ein boolescher Wert, der angibt, ob das Element, das in eine XML-Zeichenfolge geschrieben werden soll, auf null festlegbar ist oder nicht. Folgendes steht zur Auswahl:
  • Wenn der Wert false (falsch) ist (dies ist der Standardwert), schreibt die EGL-Laufzeit ein Element, dessen Inhalt null ist, nicht in die XML-Zeichenfolge.
  • Wenn der Wert true (wahr) ist, resultiert der Versuch, eine Null aus dem Datensatz in die XML-Zeichenfolge zu schreiben, in einem leeren Element, das den Attributwert xsi:nil="true" und keine weiteren Attribute enthält.

Der nullfähig Aspekt eines Datensatzfelds wirkt sich auf das Verhalten aus, wenn die EGL-Laufzeit eine XML-Zeichenfolge in einen Datensatz liest. Details hierzu finden Sie im Thema XML-Zeichenfolge in und aus EGL-Variablen kopieren.


Feedback