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.