SAX OPEN XML ELEMENT
SAX OPEN XML ELEMENT ( document ; tag {; attribName ; attribValue} {; attribName2 ; attribValue2 ; ... ; attribNameN ; attribValueN} )
| 引数 | 型 | 説明 | |
|---|---|---|---|
| document | DocRef | 🡒 | 開いたドキュメントの参照 |
| tag | 文字 | 🡒 | 開く要素の名前 |
| attribName | 文字 | 🡒 | 属性名 |
| attribValue | 文字 | 🡒 | 属性値 |
説明
SAX OPEN XML ELEMENT コマンドを使用して、document で参照されるXMLドキュメント中に新しい要素およびオプションで属性とその値を追加できます。
追加された要素はドキュメント中で開かれた状態です (終了タグは追加されません)。作成した要素を閉じるには、以下のいずれかの方法を使用します:
- SAX CLOSE XML ELEMENT コマンドを使用する
- XMLドキュメントを閉じる。4Dは自動で必要なXML終了タグを追加します。
tagには、作成する要素の名前を渡します。この名前には文字、数字 “.”, “-“,”_” aや “:”.などの文字のみを渡せます。名前はXMLの仕様に従っていなければなりません。無効な文字がtagに渡されると、エラーが生成されます。
オプションでattribNameとattribValue引数を使用し、(変数、フィールド、またはリテラル値で) コマンドに1つ以上の属性名/値のペアを渡すことができます。
例題
以下のコードは:
vElement:="Book"
SAX OPEN XML ELEMENT($DocRef;vElement)
ドキュメントに以下の行を書き込みます:
<Book
エラー管理
tagに無効な文字が渡されるとエラーが生成されます。