XMLDocumentオブジェクト
コンポーネント情報 | |
---|---|
version | 1.0 |
since | 3.0 |
XMLを解析するパーサーオブジェクト。
XML を解析するパーサーを提供します。
このオブジェクトでは、XML の各タグをノードとして管理します。
各ノードは、属性と子供ノードを持ちます。
属性と子供ノードは複数持つ事ができ、子供ノードは更に属性と子供ノードを持つ事が出来ます。 すべてのノードの頂点となる親ノード(ドキュメントノード)は、XML ソース中の最も外側のタグであり、getDocumentElement() によって取得する事が出来ます。
ドキュメントノードが複数存在する場合は、XML 解析エラーとなりますのでご注意下さい。
XMLを解析してDOMツリーを作成するには、コンストラクタを使います。
例えば、以下のようなXML
<A>
<B>Bタグの中のテキスト</B>
<C>Cタグの中のテキスト</C>
</A>
から、<C> タグに囲まれたテキスト値を取得する場合は以下のようにプログラムします。
var xml = "<A><B>Bタグの中のテキスト</B><C>Cタグの中のテキスト</C></A>";
var dom = new XMLDocument(xml);
var elms = dom.getElementsByTagName("C");
var elm = elms[0];
var childs = elm.getChildNodes();
var data = childs[0].getValue();
Debug.print("C's text: " + data);
XML を解析するパーサーを提供します。
このオブジェクトでは、XML の各タグをノードとして管理します。
各ノードは、属性と子供ノードを持ちます。
属性と子供ノードは複数持つ事ができ、子供ノードは更に属性と子供ノードを持つ事が出来ます。 すべてのノードの頂点となる親ノード(ドキュメントノード)は、XML ソース中の最も外側のタグであり、getDocumentElement() によって取得する事が出来ます。
ドキュメントノードが複数存在する場合は、XML 解析エラーとなりますのでご注意下さい。
XMLを解析してDOMツリーを作成するには、コンストラクタを使います。
例えば、以下のようなXML
<A>
<B>Bタグの中のテキスト</B>
<C>Cタグの中のテキスト</C>
</A>
から、<C> タグに囲まれたテキスト値を取得する場合は以下のようにプログラムします。
var xml = "<A><B>Bタグの中のテキスト</B><C>Cタグの中のテキスト</C></A>";
var dom = new XMLDocument(xml);
var elms = dom.getElementsByTagName("C");
var elm = elms[0];
var childs = elm.getChildNodes();
var data = childs[0].getValue();
Debug.print("C's text: " + data);
コンストラクタの概要
XMLDocument (String src ) コンストラクタ。 |
メソッドの概要
返却値の型 | メソッド名 |
---|---|
DOMNode | createElement (String tagName ) 新しいノードを作成します。 |
DOMNode | createTextNode (String data ) 新しいテキストノードを作成します。 |
DOMDocumentType | getDoctype () ドキュメントタイプを取得します。 |
DOMNode | getDocumentElement () Documentノードを取得します。 |
DOMNode | getElementById (String elementId ) 識別子に該当するノードを取得します。 |
Array | getElementsByTagName (String tagname ) 指定のタグにマッチするエレメントを取得します。 |
String | getXmlString () XMLの文字列を取得します。 |
Boolean | isError () エラー発生のチェックを行います。 |
コンストラクタの詳細
XMLDocument (String src )
コンストラクタ。
XML ソースを解析して各エンティティを操作するためのオブジェクトを構築します。
パラメータ
|
メソッドの詳細
DOMNode createElement (String tagName )
新しいノードを作成します。
パラメータ
返却値
|
DOMNode createTextNode (String data )
新しいテキストノードを作成します。
パラメータ
返却値
|
DOMDocumentType getDoctype ()
ドキュメントタイプを取得します。
返却値
|
DOMNode getDocumentElement ()
Documentノードを取得します。
返却値
|
DOMNode getElementById (String elementId )
識別子に該当するノードを取得します。
指定の識別子にマッチしたノードを返します。 指定の識別子を持つノードが存在しなかった場合 null を返します。
パラメータ
返却値
|
Array getElementsByTagName (String tagname )
指定のタグにマッチするエレメントを取得します。
XML ソース中から指定のタグに該当するエンティティを返します。 返却値は、DOMNode オブジェクトを要素に持つ配列です。 不整合が発生してデータが取得できなかった場合 null が返ります。
パラメータ
返却値
|
String getXmlString ()
XMLの文字列を取得します。
返却値
|
Boolean isError ()
エラー発生のチェックを行います。
XML ソースを解析中にエラーが発生していた場合 true を返します。
返却値
|