パッケージトップレベル
Classpublic final dynamic class XMLList
継承XMLList Inheritance Object

XMLList クラスには、XML エレメントを操作するためのメソッドが含まれています。XMLList オブジェクトは複数の XML オブジェクトまたはエレメント（複数のノードまたは属性を含む）を表すこともできるので、コレクション内のエレメント全体に対してメソッドを呼び出すことも、コレクション内のエレメントごとにメソッドを呼び出すことも可能です。

XMLList オブジェクトに XML エレメントが 1 つしかない場合は、XMLList オブジェクトに対して XML クラスのメソッドを直接使用できます。次の例で、example.two は長さ 1 の XMLList オブジェクトです。そのため、このオブジェクトにはどのような XML メソッドをも呼び出すことができます。

 var example2 = <example><two>2</two></example>;

複数の XML オブジェクトを含んだ XMLList オブジェクトと共に XML クラスのメソッドを使用しようとすると、例外がスローされます。例外がスローされないようにするには、for each..in ステートメントなどを使用して XMLList コレクションに対して反復処理を行い、コレクション内の各 XML オブジェクトにメソッドを適用します。

例を表示

関連項目

XML
for each..in
Namespace
QName

パブリックプロパティ
 プロパティ定義元
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
パブリックメソッド
 メソッド定義元
  
XMLList(value:Object)
新しい XMLList オブジェクトを作成します。
XMLList
  
attribute(attributeName:*):XMLList
各 XML オブジェクトの attribute() メソッドを呼び出し、その結果の XMLList オブジェクトを返します。
XMLList
  
attributes():XMLList
各 XML オブジェクトの attributes() メソッドを呼び出し、各 XML オブジェクトの属性の XMLList オブジェクトを返します。
XMLList
  
child(propertyName:Object):XMLList
各 XML オブジェクトの child() メソッドを呼び出し、その結果を順に含む XMLList オブジェクトを返します。
XMLList
  
children():XMLList
各 XML オブジェクトの children() メソッドを呼び出し、その結果を含む XMLList オブジェクトを返します。
XMLList
  
comments():XMLList
各 XML オブジェクトの comments() メソッドを呼び出し、コメントの XMLList を返します。
XMLList
  
contains(value:XML):Boolean
指定された value パラメータに等しい XML オブジェクトが XMLList オブジェクトに含まれるかどうかを確認します。
XMLList
  
copy():XMLList
指定された XMLList オブジェクトのコピーを返します。
XMLList
  
descendants(name:Object = *):XMLList
指定された name パラメータを持つ XML オブジェクトのすべての子孫（子、孫、ひ孫など）を返します。
XMLList
  
elements(name:Object = *):XMLList
各 XML オブジェクトの elements() メソッドを呼び出します。
XMLList
  
hasComplexContent():Boolean
XMLList オブジェクトに複合内容が含まれるかどうかを確認します。
XMLList
  
hasOwnProperty(p:String):Boolean
p により指定されたプロパティをチェックします。
XMLList
  
hasSimpleContent():Boolean
XMLList オブジェクトに単純内容が含まれるかどうかを確認します。
XMLList
 Inherited
isPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
  
length():int
XMLList オブジェクト内のプロパティ数を返します。
XMLList
  
normalize():XMLList
隣接するテキストノードを結合し、XMLList 内のすべてのテキストノード、XMLList に含まれるすべての XML オブジェクト、および XMLList 内のすべての XML オブジェクトの子孫について、それぞれ空のテキストノードを削除します。
XMLList
  
parent():Object
XMLList オブジェクト内のすべてのアイテムが同じ親を持つ場合、XMLList オブジェクトの親を返します。
XMLList
  
processingInstructions(name:String = "*"):XMLList
name パラメータを指定した場合は、その名前を持つ処理命令を含む XMLList オブジェクトのすべての子を一覧表示します。
XMLList
  
propertyIsEnumerable(p:String):Boolean
XML オブジェクトに適用される for..in ステートメント内で反復処理されるプロパティセット内に、プロパティ p があるかどうかを確認します。
XMLList
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
  
text():XMLList
各 XML オブジェクトの text() メソッドを呼び出し、その結果を含む XMLList オブジェクトを返します。
XMLList
  
toString():String
XMLList オブジェクト内のすべての XML オブジェクトのストリング表現を返します。
XMLList
  
toXMLString():String
XMLList オブジェクト内のすべての XML オブジェクトのストリング表現を返します。
XMLList
  
valueOf():XMLList
XMLList オブジェクトを返します。
XMLList
コンストラクタの詳細
XMLList()コンストラクタ
public function XMLList(value:Object)

新しい XMLList オブジェクトを作成します。

パラメータ
value:Object — トップレベル関数 XMLList() によって XMLList オブジェクトに変換可能なオブジェクトです。

関連項目

top-level XMLList() 関数
メソッドの詳細
attribute()メソッド
AS3 function attribute(attributeName:*):XMLList

各 XML オブジェクトの attribute() メソッドを呼び出し、その結果の XMLList オブジェクトを返します。この結果は、指定された attributeName パラメータに一致します。一致する XML オブジェクトがなかった場合、attribute() メソッドは空の XMLList オブジェクトを返します。

パラメータ

attributeName:* — XMLList オブジェクト内に含める属性の名前です。

戻り値
XMLList — XML オブジェクトが一致する XMLList オブジェクト、または空の XMLList オブジェクトです。

関連項目

XML.attribute()
XML.attributes()
XMLList objects
attributes()メソッド 
AS3 function attributes():XMLList

各 XML オブジェクトの attributes() メソッドを呼び出し、各 XML オブジェクトの属性の XMLList オブジェクトを返します。

戻り値
XMLList — 各 XML オブジェクトの属性の XMLList オブジェクトです。

関連項目

XML.attribute()
XML.attributes()
XMLList objects
child()メソッド 
AS3 function child(propertyName:Object):XMLList

各 XML オブジェクトの child() メソッドを呼び出し、その結果を順に含む XMLList オブジェクトを返します。

パラメータ

propertyName:Object — XML の子のエレメント名または整数です。

戻り値
XMLList — 入力パラメータに一致する子ノードの XMLList オブジェクトです。

関連項目

XML.child()
XMLList objects
children()メソッド 
AS3 function children():XMLList

各 XML オブジェクトの children() メソッドを呼び出し、その結果を含む XMLList オブジェクトを返します。

戻り値
XMLList — XML オブジェクト内の子（複数）の XMLList オブジェクトです。

関連項目

XML.children()
XMLList objects
comments()メソッド 
AS3 function comments():XMLList

各 XML オブジェクトの comments() メソッドを呼び出し、コメントの XMLList を返します。

戻り値
XMLList — XML オブジェクト内のコメントの XMLList です。

関連項目

XML.comments()
XMLList objects
contains()メソッド 
AS3 function contains(value:XML):Boolean

指定された value パラメータに等しい XML オブジェクトが XMLList オブジェクトに含まれるかどうかを確認します。

パラメータ

value:XML — 現在の XMLList オブジェクトと比較する XML オブジェクトです。

戻り値
Boolean — value パラメータで宣言された XML オブジェクトが XMLList オブジェクトに含まれる場合は true、それ以外の場合は false を返します。

関連項目

XMLList objects
copy()メソッド 
AS3 function copy():XMLList

指定された XMLList オブジェクトのコピーを返します。コピーとはノードのツリー全体の複製です。コピーされた XML オブジェクトに親はないので、null が返されます（parent() メソッドを呼び出した場合）。

戻り値
XMLList — XMLList オブジェクトのコピーです。

関連項目

XMLList objects
descendants()メソッド 
AS3 function descendants(name:Object = *):XMLList

指定された name パラメータを持つ XML オブジェクトのすべての子孫（子、孫、ひ孫など）を返します。name パラメータには、QName オブジェクト、String データ型、または他の任意のデータ型（後で String データ型に変換されます）を指定できます。

すべての子孫を返すには、アスタリスク（*）パラメータを使用します。パラメータを指定しない場合はストリング "*" が渡され、XML オブジェクトのすべての子孫が返されます。

パラメータ

name:Object (default = *) — 照合するエレメントの名前です。

戻り値
XMLList — 元のリスト内の一致する XML オブジェクトの子孫（子、孫など）の XMLList オブジェクトです。子孫がない場合は、空の XMLList オブジェクトを返します。

関連項目

XML.descendants()
XMLList objects
elements()メソッド 
AS3 function elements(name:Object = *):XMLList

各 XML オブジェクトの elements() メソッドを呼び出します。name パラメータが descendants() メソッドに渡されます。パラメータが渡されなかった場合、ストリング "*" が descendants() メソッドに渡されます。

パラメータ

name:Object (default = *) — 照合するエレメントの名前です。

戻り値
XMLList — 一致する XML オブジェクトの子エレメントの XMLList オブジェクトです。

関連項目

XML.elements()
hasComplexContent()メソッド 
AS3 function hasComplexContent():Boolean

XMLList オブジェクトに複合内容が含まれるかどうかを確認します。XMLList オブジェクトが空でなく、次のいずれかの条件が true の場合に、XMLList オブジェクトは複合内容を持つと見なされます。

戻り値
Boolean — XMLList オブジェクトに複合内容が含まれる場合は true、それ以外の場合は false を返します。

関連項目

hasSimpleContent()
XML.hasComplexContent()
XML.hasSimpleContent()
XMLList objects
hasOwnProperty()メソッド 
AS3 function hasOwnProperty(p:String):Boolean

p により指定されたプロパティをチェックします。

パラメータ

p:String — 照合するプロパティです。

戻り値
Boolean — パラメータが存在する場合は true、それ以外の場合は false を返します。

関連項目

XMLList objects
hasSimpleContent()メソッド 
AS3 function hasSimpleContent():Boolean

XMLList オブジェクトに単純内容が含まれるかどうかを確認します。次のいずれかの条件が true の場合に、XMLList オブジェクトは単純内容を持つと見なされます。

戻り値
Boolean — XMLList に単純内容が含まれる場合は true、それ以外の場合は false を返します。

関連項目

hasComplexContent()
XML.hasComplexContent()
XML.hasSimpleContent()
XMLList objects
length()メソッド 
AS3 function length():int

XMLList オブジェクト内のプロパティ数を返します。

戻り値
int — XMLList オブジェクト内のプロパティ数です。

関連項目

XMLList objects
normalize()メソッド 
AS3 function normalize():XMLList

隣接するテキストノードを結合し、XMLList 内のすべてのテキストノード、XMLList に含まれるすべての XML オブジェクト、および XMLList 内のすべての XML オブジェクトの子孫について、それぞれ空のテキストノードを削除します。

戻り値
XMLList — 正規化した XMLList オブジェクトです。

関連項目

XMLList objects
parent()メソッド 
AS3 function parent():Object

XMLList オブジェクト内のすべてのアイテムが同じ親を持つ場合、XMLList オブジェクトの親を返します。XMLList オブジェクトが親を持たないか、異なる親を持つ場合、メソッドは undefined を返します。

戻り値
Object — 親 XML オブジェクトを返します。

関連項目

XMLList objects
processingInstructions()メソッド 
AS3 function processingInstructions(name:String = "*"):XMLList

name パラメータを指定した場合、その名前を持つ処理命令を含む XMLList オブジェクトのすべての子を一覧表示します。パラメータを指定しなかった場合、メソッドは任意の処理命令を含む XMLList オブジェクトのすべての子を一覧表示します。

パラメータ

name:String (default = "*") — 照合する処理命令の名前です。

戻り値
XMLList — 各 XML オブジェクトの処理命令を含む XMLList オブジェクトです。

関連項目

XML.processingInstructions()
XMLList objects
propertyIsEnumerable()メソッド 
AS3 function propertyIsEnumerable(p:String):Boolean

プロパティ p が、XMLList オブジェクトに適用される for..in ステートメント内で反復処理されるプロパティセット内にあるかどうかを確認します。true が返るのは、toNumber(p) が 0 より大きいか等しく、かつ XMLList オブジェクトの長さより小さい場合のみです。

パラメータ

p:String — 確認するプロパティのインデックスです。

戻り値
Boolean — for..in ステートメント内でプロパティを反復処理できる場合は true、それ以外の場合は false を返します。

関連項目

XMLList objects
text()メソッド 
AS3 function text():XMLList

各 XML オブジェクトの text() メソッドを呼び出し、その結果を含む XMLList オブジェクトを返します。

戻り値
XMLList — XML テキストノードを表す XMLList オブジェクトのすべての XML プロパティの XMLList オブジェクトです。

関連項目

XML.text()
XMLList objects
toString()メソッド 
AS3 function toString():String

XMLList オブジェクト内のすべての XML オブジェクトのストリング表現を返します。この変換の規則は、XML オブジェクトに単純内容が含まれるか、複合内容が含まれるかによって決まります。

XML オブジェクト全体を毎回返すには、toXMLString() メソッドを使用します。

戻り値
String — XML オブジェクトのストリング表現です。

関連項目

hasComplexContent()
hasSimpleContent()
toXMLString()
XMLList objects
XML type conversion

例

次の例は、XML オブジェクトに単純内容が含まれる場合に toString() メソッドによって何が返されるかを示しています。 
var test:XML = <type name="Joe">example</type>;
trace(test.toString()); //example

次の例は、XML オブジェクトに複合内容が含まれる場合に toString() メソッドによって何が返されるかを示しています。 
var test:XML = 
<type name="Joe">
    <base name="Bob"></base>
    example
</type>;
trace(test.toString());
  // <type name="Joe">
  // <base name="Bob"/>
  // example
  // </type>
toXMLString()メソッド 
AS3 function toXMLString():String

XMLList オブジェクト内のすべての XML オブジェクトのストリング表現を返します。toString() メソッドとは異なり、toXMLString() メソッドは、XML オブジェクトに単純内容が含まれるか、複合内容が含まれるかに関係なく、常に XML オブジェクトの開始タグ、属性、および終了タグを返します。toString() メソッドは、単純内容を持つ XML オブジェクトの開始タグ、属性、および終了タグを削除します。

戻り値
String — XML オブジェクトのストリング表現です。

関連項目

toString()
XMLList objects
XML type conversion
valueOf()メソッド 
AS3 function valueOf():XMLList

XMLList オブジェクトを返します。

戻り値
XMLList — 現在の XMLList オブジェクトを返します。

関連項目

XMLList objects
例 例の使用法
XMLListExample.as

次の例は books という名前の XML プロパティを作成し、book publisher タグや name タグを持ついくつかのアイテムを books というノードに追加しています。次に showBooksByPublisher() メソッドを呼び出します。このメソッドは XMLList を受け取り、発行者 "Addison-Wesley" に一致する各アイテムを返します。 
package {
    import flash.display.Sprite;

    public class XMLListExample extends Sprite {
        private var books:XML;

        public function XMLListExample() {
            books =    <books>
                        <book publisher="Addison-Wesley" name="Design Patterns" />
                        <book publisher="Addison-Wesley" name="The Pragmatic Programmer" />
                        <book publisher="Addison-Wesley" name="Test Driven Development" />
                        <book publisher="Addison-Wesley" name="Refactoring to Patterns" />
                        <book publisher="O'Reilly Media" name="The Cathedral & the Bazaar" />
                        <book publisher="O'Reilly Media" name="Unit Test Frameworks" />
                    </books>;

            showBooksByPublisher("Addison-Wesley");
        }

        private function showBooksByPublisher(name:String):void {
            var results:XMLList = books.book.(@publisher == name);
            showList(results);
        }

        private function showList(list:XMLList):void {
            var item:XML;
            for each(item in list) {
                trace("item: " + item.toXMLString());
            }
        }
    }
}



© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Thu Jul 24 2008, 12:42 AM -07:00

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/XMLList.html