XMLList

Paket	Üst Düzey
Sınıf	public final dynamic class XMLList
Miras Alma	XMLList Object

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

XMLList sınıfı, bir veya birden çok XML öğesiyle çalışmak için yöntemler içerir. XMLList nesnesi bir veya daha fazla XML nesnesini veya öğesini (birden fazla düğüm veya nitelik dahil) temsil edebilir; böylece grup olarak öğelerdeki veya koleksiyon içinde bulunan bağımsız öğelerdeki yöntemleri çağırabilirsiniz.

XMLList nesnesinde yalnızca bir XML öğesi varsa XMLList nesnesindeki XML sınıfı yöntemlerini doğrudan kullanabilirsiniz. Şu örnekte, example.two, uzunluğu 1 olan bir XMLList nesnesidir; bu yüzden bu nesne üzerindeki herhangi bir XML yöntemini çağırabilirsiniz.

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

XML sınıfı yöntemlerini bir veya daha fazla XML nesnesi içeren bir XMLList nesnesiyle kullanmayı denerseniz, bir istisna atılır; bunun yerine, XMLList koleksiyonunu yineleyin (örneğin for each..in ifadesini kullanarak) ve yöntemleri koleksiyondaki her XML nesnesine uygulayın.

Örnekleri görüntüle

İlgili API Öğeleri

XML
for each..in
Namespace
QName

Genel Özellikler

Miras Alınan Genel Özellikleri Gizle

Miras Alınan Genel Özellikleri Göster

	Özellik		Tanımlayan:
		constructor : Object Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru.	Object

Genel Yöntemler

Miras Alınan Genel Yöntemleri Gizle

Miras Alınan Genel Yöntemleri Göster

	Yöntem		Tanımlayan:
		XMLList(value:Object) Yeni bir XMLList nesnesi oluşturur.	XMLList
		attribute(attributeName:*):XMLList Her XML nesnesinin attribute() yöntemini çağırır ve sonuçların bir XMLList nesnesini döndürür.	XMLList
		attributes():XMLList Her XML nesnesinin attributes() yöntemini çağırır ve her XML nesnesinin niteliklerinden oluşan bir XMLList nesnesi döndürür.	XMLList
		child(propertyName:Object):XMLList Her XML nesnesinin child() yöntemini çağırır ve sonuçları sıralı olarak içeren bir XMLList nesnesi döndürür.	XMLList
		children():XMLList Her XML nesnesinin children() yöntemini çağırır ve sonuçları içeren bir XMLList nesnesi döndürür.	XMLList
		comments():XMLList Her XML nesnesinin comments() yöntemini çağırır ve yorumlardan oluşan bir XMLList listesini döndürür.	XMLList
		contains(value:XML):Boolean XMLList nesnesinin belirli bir value parametresine eşit bir XML nesnesi içerip içermediğini kontrol eder.	XMLList
		copy():XMLList Belirli XMLList nesnesinin bir kopyasını döndürür.	XMLList
		descendants(name:Object = *):XMLList XML nesnesinin belirli bir name parametresine sahip tüm alt öğelerini (alt öğe, alt alt öğe vb.) döndürür.	XMLList
		elements(name:Object = *):XMLList Her XML nesnesinin elements() yöntemini çağırır.	XMLList
		hasComplexContent():Boolean XMLList nesnesinde karmaşık içerik olup olmadığını kontrol eder.	XMLList
		hasOwnProperty(p:String):Boolean p tarafından belirtilen özelliği kontrol eder.	XMLList
		hasSimpleContent():Boolean XMLList nesnesinde basit içerik olup olmadığını kontrol eder.	XMLList
		isPrototypeOf(theClass:Object):Boolean Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir.	Object
		length():int XMLList nesnesindeki özelliklerin sayısını döndürür.	XMLList
		normalize():XMLList Şunların her birinin bitişik metin düğümlerini birleştirir ve boş metin düğümlerini çıkarır: XMLList'teki tüm metin düğümleri, XMLList'teki tüm XML nesneleri ve XMLList'teki tüm XML nesnelerinin alt öğeleri.	XMLList
		parent():Object XMLList nesnesindeki tüm öğelerin üst öğesi aynıysa XMLList nesnesinin üst öğesini döndürür.	XMLList
		processingInstructions(name:String = "*"):XMLList Bir name parametresi sağlanırsa, XMLList nesnesinin bu name değerine sahip işleme talimatları içeren tüm alt öğelerini listeler.	XMLList
		propertyIsEnumerable(p:String):Boolean p özelliğinin, XML nesnesine uygulanan bir for..in ifadesinde yinelenebilen özellikler kümesinde olup olmadığını kontrol eder.	XMLList
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar.	Object
		text():XMLList Her XML nesnesinin text() yöntemini çağırır ve sonuçları içeren bir XMLList nesnesi döndürür.	XMLList
		toLocaleString():String Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür.	Object
		toString():String Bir XMLList nesnesindeki tüm XML nesnelerinin dize ile temsil edilen halini döndürür.	XMLList
		toXMLString():String Bir XMLList nesnesindeki tüm XML nesnelerinin dize ile temsil edilen halini döndürür.	XMLList
		valueOf():XMLList XMLList nesnesini döndürür.	XMLList

Yapıcı Ayrıntı

()

Yapıcı

public function XMLList(value:Object)

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9

Yeni bir XMLList nesnesi oluşturur.

Parametreler

value:Object — Üst düzey XMLList( işlevi kullanılarak bir XMLList nesnesine dönüştürülebilen herhangi bir nesne.

İlgili API Öğeleri

üst düzey XMLList() işlevi

Yöntem Ayrıntısı

attribute

()

yöntem

AS3 function attribute(attributeName:*):XMLList

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9

Her XML nesnesinin attribute() yöntemini çağırır ve sonuçların bir XMLList nesnesini döndürür. Sonuçlar belirli bir attributeName parametresiyle eşlenir. Eşleme yoksa, attribute() yöntemi boş bir XMLList nesnesi döndürür.

Parametreler

attributeName:* — XMLList nesnesine dahil etmek istediğiniz niteliğin adı.

Döndürür

XMLList — Eşlenen XML nesnelerinden oluşan bir XMLList nesnesi veya boş bir XMLList nesnesi.

İlgili API Öğeleri

XML.attribute()
XML.attributes()

attributes

()

yöntem

AS3 function attributes():XMLList

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9

Her XML nesnesinin attributes() yöntemini çağırır ve her XML nesnesinin niteliklerinden oluşan bir XMLList nesnesi döndürür.

Döndürür

XMLList — Her XML nesnesinin niteliklerinden oluşan bir XMLList nesnesi.

İlgili API Öğeleri

XML.attribute()
XML.attributes()

child

()

yöntem

AS3 function child(propertyName:Object):XMLList

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9

Her XML nesnesinin child() yöntemini çağırır ve sonuçları sıralı olarak içeren bir XMLList nesnesi döndürür.

Parametreler

propertyName:Object — Alt XML'in öğe adı veya tam sayısı

Döndürür

XMLList — input parametresiyle eşlenen alt düğümlerden oluşan bir XMLList nesnesi.

İlgili API Öğeleri

XML.child()

children

()

yöntem

AS3 function children():XMLList

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9

Her XML nesnesinin children() yöntemini çağırır ve sonuçları içeren bir XMLList nesnesi döndürür.

Döndürür

XMLList — XML nesnelerindeki alt öğelerden oluşan bir XMLList nesnesi

İlgili API Öğeleri

XML.children()

comments

()

yöntem

AS3 function comments():XMLList

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9

Her XML nesnesinin comments() yöntemini çağırır ve yorumlardan oluşan bir XMLList listesini döndürür.

Döndürür

XMLList — XML nesnelerindeki yorumlardan oluşan bir XMLList nesnesi.

İlgili API Öğeleri

XML.comments()

contains

()

yöntem

AS3 function contains(value:XML):Boolean

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9

XMLList nesnesinin belirli bir value parametresine eşit bir XML nesnesi içerip içermediğini kontrol eder.

Parametreler

value:XML — Geçerli XMLList nesnesiyle karşılaştırılacak olan XML nesnesi.

Döndürür

Boolean — XMLList, value parametresinde bildirilen XML nesnesini içeriyorsa true; içermiyorsa false.

copy

()

yöntem

AS3 function copy():XMLList

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9

Belirli XMLList nesnesinin bir kopyasını döndürür. Kopya, tüm düğüm ağacının aynısıdır. Kopyalanan XML nesnesinin üst öğesi yoktur ve parent() yöntemini çağırmayı denerseniz null değerini döndürür.

Döndürür

XMLList — XMLList nesnesinin kopyası.

descendants

()

yöntem

AS3 function descendants(name:Object = *):XMLList

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9

XML nesnesinin belirli bir name parametresine sahip tüm alt öğelerini (alt öğe, alt alt öğe vb.) döndürür. name parametresi bir QName nesnesi, String veri türü veya daha sonra String veri türüne dönüştürülecek herhangi bir veri türü olabilir.

Tüm alt öğeleri döndürmek için asterisk (*) parametresini kullanın. Herhangi bir parametre iletilmezse, "*" dizesi iletilir ve XML nesnesinin tüm alt öğelerini döndürür.

Parametreler

name:Object (default = *) — Eşlenecek öğenin adı.

Döndürür

XMLList — Orijinal listedeki XML nesnelerinin eşlenen alt öğelerinden (alt öğe, alt alt öğe vb.) oluşan bir XMLList nesnesi. Alt öğe yoksa boş bir XMLList nesnesini döndürür.

İlgili API Öğeleri

XML.descendants()

elements

()

yöntem

AS3 function elements(name:Object = *):XMLList

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9

Her XML nesnesinin elements() yöntemini çağırır. name parametresi descendants() yöntemine iletilir. Herhangi bir parametre iletilmezse, descendants() yöntemine "*" dizesi iletilir.

Parametreler

name:Object (default = *) — Eşlenecek öğelerin adı.

Döndürür

XMLList — XML nesnelerinin eşlenen alt öğelerinden oluşan bir XMLList nesnesi.

İlgili API Öğeleri

XML.elements()

hasComplexContent

()

yöntem

AS3 function hasComplexContent():Boolean

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9

XMLList nesnesinde karmaşık içerik olup olmadığını kontrol eder. XMLList nesnesi boş değilse ve aşağıdaki koşullardan biri doğruysa XMLList nesnesinin karmaşık içeriğe sahip olduğu düşünülür:

XMLList nesnesi karmaşık içeriğe sahip tek bir XML öğesi içerir.
XMLList nesnesi öğeler içerir.

Döndürür

Boolean — XMLList nesnesinde karmaşık içerik varsa true; yoksa false.

İlgili API Öğeleri

hasSimpleContent()
XML.hasComplexContent()
XML.hasSimpleContent()

hasOwnProperty

()

yöntem

AS3 function hasOwnProperty(p:String):Boolean

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9

p tarafından belirtilen özelliği kontrol eder.

Parametreler

p:String — Eşleşecek özellik.

Döndürür

Boolean — Parametre varsa true, yoksa false.

hasSimpleContent

()

yöntem

AS3 function hasSimpleContent():Boolean

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9

XMLList nesnesinde basit içerik olup olmadığını kontrol eder. Şu koşullardan biri veya birkaçı doğruysa, XMLList nesnesinin basit içeriğe sahip olduğu düşünülür:

XMLList nesnesi boş
XMLList nesnesi basit içeriğe sahip tek bir XML öğesi içeriyor
XMLList nesnesi öğe içermiyor

Döndürür

Boolean — XMLList nesnesinde basit içerik varsa true; yoksa false.

İlgili API Öğeleri

hasComplexContent()
XML.hasComplexContent()
XML.hasSimpleContent()

length

()

yöntem

AS3 function length():int

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9

XMLList nesnesindeki özelliklerin sayısını döndürür.

Döndürür

int — XMLList nesnesindeki özelliklerin sayısı.

normalize

()

yöntem

AS3 function normalize():XMLList

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9

Şunların her birinin bitişik metin düğümlerini birleştirir ve boş metin düğümlerini çıkarır: XMLList'teki tüm metin düğümleri, XMLList'teki tüm XML nesneleri ve XMLList'teki tüm XML nesnelerinin alt öğeleri.

Döndürür

XMLList — Normalleştirilmiş XMLList nesnesi.

parent

()

yöntem

AS3 function parent():Object

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9

XMLList nesnesindeki tüm öğelerin üst öğesi aynıysa XMLList nesnesinin üst öğesini döndürür. XMLList nesnesinin üst öğesi yoksa veya üst öğeleri farklıysa yöntem undefined değeri döndürür.

Döndürür

Object — Üst XML nesnesini döndürür.

processingInstructions

()

yöntem

AS3 function processingInstructions(name:String = "*"):XMLList

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9

Bir name parametresi sağlanırsa, XMLList nesnesinin bu name değerine sahip işleme talimatları içeren tüm alt öğelerini listeler. Parametre olmadığında, yöntem, XMLList nesnesinin herhangi bir işleme talimatı içeren tüm alt öğelerini listeler

Parametreler

name:String (default = "*") — Eşleşecek işleme talimatlarının adı.

Döndürür

XMLList — Her XML nesnesi için işleme talimatları içeren bir XMLList nesnesi.

İlgili API Öğeleri

XML.processingInstructions()

propertyIsEnumerable

()

yöntem

AS3 function propertyIsEnumerable(p:String):Boolean

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9

p özelliğinin, XML nesnesine uygulanan bir for..in ifadesinde yinelenebilen özellikler kümesinde olup olmadığını kontrol eder. Bu yalnızca toNumber(p) değeri 0'a eşit veya 0'dan büyükse ve XMLList nesnesinin uzunluğundan küçükse true olur.

Parametreler

p:String — Denetlenecek özelliğin dizini.

Döndürür

Boolean — Özellik, for..in ifadesinde yinelenebiliyorsa, true; aksi takdirde false olur.

text

()

yöntem

AS3 function text():XMLList

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9

Her XML nesnesinin text() yöntemini çağırır ve sonuçları içeren bir XMLList nesnesi döndürür.

Döndürür

XMLList — XML metin düğümlerini temsil eden XMLList nesnesinin tüm XML özelliklerinden oluşan bir XMLList nesnesi.

İlgili API Öğeleri

XML.text()

toString

()

yöntem

AS3 function toString():String

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9

Bir XMLList nesnesindeki tüm XML nesnelerinin dize ile temsil edilen halini döndürür. Bu dönüştürmeyle ilgili kurallar XML nesnesinin basit içeriğe veya karmaşık içeriğe sahip olmasına bağlıdır.

XML nesnesi basit içeriğe sahipse toString() yöntemi XML nesnesinin dize içeriğini şu öğeler ayıklanmış olarak döndürür: başlangıç etiketi, nitelikler, ad alanı bildirimleri ve bitiş etiketi.

XML nesnesi karmaşık içeriğe sahipse toStirng() yöntemi, başlangıç etiketi, nitelikler, ad alanı bildirimleri ve bitiş etiketi de dahil olmak üzere tüm XML nesnesini temsil eden XML kodlu bir dize döndürür.

Her defasında tüm XML nesnesini döndürmek için toXMLString() yöntemini kullanın.

Döndürür

String — XML nesnesinin dize olarak temsili.

İlgili API Öğeleri

hasComplexContent()
hasSimpleContent()
toXMLString()

Örnek ( Bu örnek nasıl kullanılır? )

Şu örnek, XML nesnesi basit içeriğe sahip olduğunda toStirng() yönteminin ne döndüreceğini gösterir:

var test:XML = <type name="Joe">example</type>;
trace(test.toString()); //example

Şu örnek, XML nesnesi karmaşık içeriğe sahip olduğunda toStirng() yönteminin ne döndüreceğini gösterir:

var test:XML = 
<type name="Joe">
    <base name="Bob"></base>
    example
</type>;
trace(test.toString());
  // <type name="Joe">
  // <base name="Bob"/>
  // example
  // </type>

toXMLString

()

yöntem

AS3 function toXMLString():String

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9

Bir XMLList nesnesindeki tüm XML nesnelerinin dize ile temsil edilen halini döndürür. toString() yönteminin tersine toXMLString() yöntemi XML nesnesinin basit içeriğe veya karmaşık içeriğe sahip olmasına bakmadan her zaman başlangıç etiketini, nitelikleri ve bitiş etiketini döndürür. (toString() yöntemi basit içeriğe sahip XML nesneleri için bu öğeleri ayıklar.)

Döndürür

String — XML nesnesinin dize olarak temsili.

İlgili API Öğeleri

toString()

valueOf

()

yöntem

AS3 function valueOf():XMLList

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9

XMLList nesnesini döndürür.

Döndürür

XMLList — Geçerli XMLList nesnesini döndürür.

Örnekler Bu örnek nasıl kullanılır?

XMLListExample.as

Şu örnek, books adlı bir XML özelliği oluşturur ve books düğümüne book publisher ve name etiketleri olan bazı öğeler ekler. Ardından, XMLList nesnesini alarak yayıncı adı "Addison-Wesley" ile eşlenen öğeleri döndüren showBooksByPublisher() yöntemi çağrılır.

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());
            }
        }
    }
}

Yasal Uyarılar | Çevrimiçi Gizlilik İlkesi

XMLList - AS3

Sınıflar x

XMLList

attribute

attributes

child

children

comments

contains

copy

descendants

elements

hasComplexContent

hasOwnProperty

hasSimpleContent

length

normalize

parent

processingInstructions

propertyIsEnumerable

text

toString

toXMLString

valueOf