XML nesneleri

Flash Player 9 ve üstü, Adobe AIR 1.0 ve üstü

XML nesnesi, bir XML öğesini, niteliği, yorumu, işleme talimatını veya metin öğesini temsil edebilir.

XML nesnesi, basit içerik veya karmaşık içerik barındırmasına göre sınıflandırılır. Alt düğümler içeren bir XML nesnesi, karmaşık içerik barındırıyor olarak sınıflandırılır. XML nesnesi şunlardan herhangi biriyse, basit içerik barındırıyor olarak sınıflandırılır: bir nitelik, bir yorum, bir işleme talimatı veya bir metin düğümü.

Örneğin, aşağıdaki XML nesnesi, bir yorum ve işleme talimatı olmak üzere karmaşık içerik barındırır:

XML.ignoreComments = false; 
XML.ignoreProcessingInstructions = false; 
var x1:XML =  
    <order> 
        <!--This is a comment. --> 
        <?PROC_INSTR sample ?> 
        <item id='1'> 
            <menuName>burger</menuName> 
            <price>3.95</price> 
        </item> 
        <item id='2'> 
            <menuName>fries</menuName> 
            <price>1.45</price> 
        </item> 
    </order>

Aşağıdaki örnekte gösterildiği gibi, yeni XML nesneleri, yorum ve işleme talimatı oluşturmak için şimdi comments() ve processingInstructions() yöntemlerini kullanabilirsiniz:

var x2:XML = x1.comments()[0]; 
var x3:XML = x1.processingInstructions()[0];

XML özellikleri

XML sınıfı beş statik özellik içerir:

  • ignoreComments ve ignoreProcessingInstructions özellikleri, XML nesnesi ayrıştırılırken yorumların veya işleme talimatlarının yok sayılıp yok sayılmayacağını belirler.

  • ignoreWhitespace özelliği, öğe etiketlerinde ve yalnızca boşluk karakterleriyle ayrılan gömülü ifadelerde boşluk karakterlerinin yok sayılıp yok sayılmayacağını belirler.

  • prettyIndentve prettyPrinting özellikleri, XML sınıfının toString() ve toXMLString() yöntemleri tarafından döndürülen metni biçimlendirmek için kullanılır.

Bu özelliklerle ilgili ayrıntılar için bkz. Adobe Flash Platformu için ActionScript 3.0 Başvurusu.

XML yöntemleri

Aşağıdaki yöntemler, XML nesnelerinin hiyerarşik yapısıyla çalışmanıza olanak sağlar:

  • appendChild()

  • child()

  • childIndex()

  • children()

  • descendants()

  • elements()

  • insertChildAfter()

  • insertChildBefore()

  • parent()

  • prependChild()

Aşağıdaki yöntemler, XML nesnesi nitelikleriyle çalışmanıza olanak sağlar:

  • attribute()

  • attributes()

Aşağıdaki yöntemler, XML nesnesi özellikleriyle çalışmanıza olanak sağlar:

  • hasOwnProperty()

  • propertyIsEnumerable()

  • replace()

  • setChildren()

Aşağıdaki yöntemler, nitelendirilmiş adlarla ve ad alanlarıyla çalışılmasına yöneliktir:

  • addNamespace()

  • inScopeNamespaces()

  • localName()

  • name()

  • namespace()

  • namespaceDeclarations()

  • removeNamespace()

  • setLocalName()

  • setName()

  • setNamespace()

Aşağıdaki yöntemler, belirli türdeki XML içerikleriyle çalışılmasına ve bu XML içeriklerinin belirlenmesine yöneliktir:

  • comments()

  • hasComplexContent()

  • hasSimpleContent()

  • nodeKind()

  • processingInstructions()

  • text()

Aşağıdaki yöntemler, dizelere dönüştürmeye ve XML nesnelerinin biçimlendirmesine yöneliktir:

  • defaultSettings()

  • setSettings()

  • settings()

  • normalize()

  • toString()

  • toXMLString()

Birkaç ek yöntem daha vardır:

  • contains()

  • copy()

  • valueOf()

  • length()

Bu yöntemlerle ilgili ayrıntılı bilgi için bkz. Adobe Flash Platformu için ActionScript 3.0 Başvurusu.