| Paket | flash.xml |
| Sınıf | public class XMLDocument |
| Miras Alma | XMLDocument  XMLNode Object |
| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
XMLNode ve XMLNodeType öğelerinin yanı sıra XMLDocument sınıfı da geriye dönük uyumluluk sağlamak üzere bulunur. XML belgelerini yükleme işlevi artık URLLoader sınıfında bulunabilir.
İlgili API Öğeleri
Miras Alınan Genel Özellikleri Gizle
Miras Alınan Genel Özellikleri Göster| Özellik | Tanımlayan: | ||
|---|---|---|---|
 | attributes : Object
Belirtilen XMLNode örneğinin tüm niteliklerini içeren bir nesne. | XMLNode | |
| childNodes : Array [salt okunur]
Belirtilen XMLNode nesnesinin alt öğesinin bir dizisi. | XMLNode | |
| constructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru. | Object | |
| docTypeDecl : Object = null
XML belgesinin DOCTYPE bildirimi hakkındaki bilgileri belirtir. | XMLDocument | ||
| firstChild : XMLNode
Belirtilen XMLDocument nesnesini değerlendirir ve üst öğenin alt öğe listesindeki ilk alt öğeye başvurur. | XMLNode | |
| idMap : Object
id niteliği atanmış XML'in düğümlerini içeren Object. | XMLDocument | ||
| ignoreWhite : Boolean = false
true'ya ayarlandığında, yalnızca beyaz boşluk içeren metin düğümleri ayrıştırma işlemi sırasında atılır. | XMLDocument | ||
| lastChild : XMLNode
Düğümün alt listesindeki son alt öğeye başvuran bir XMLNode değeri. | XMLNode | |
| localName : String [salt okunur]
XML düğümünün adının yerel ad bölümü. | XMLNode | |
| namespaceURI : String [salt okunur]
XML düğümünün bir öneki varsa namespaceURI, o önekin (URI) xmlns bildiriminin, genellikle ad alanı URI'si olarak adlandırılan değeridir. | XMLNode | |
| nextSibling : XMLNode
Üst düğümün alt listesindeki bir sonraki eş öğeye başvuran bir XMLNode değeri. | XMLNode | |
| nodeName : String
XMLNode nesnesinin düğüm adını temsil eden bir dize. | XMLNode | |
| nodeType : uint
Bir XML öğesi için XMLNodeType.ELEMENT_NODE veya bir metin düğümü için XMLNodeType.TEXT_NODE olarak bir noteType sabit değeri. | XMLNode | |
| nodeValue : String
XMLDocument nesnesinin düğüm değeri. | XMLNode | |
| parentNode : XMLNode
Belirtilen XML nesnesinin üst düğümüne başvuran veya düğümün üst öğesi yoksa null döndüren bir XMLNode değeri. | XMLNode | |
| prefix : String [salt okunur]
XML düğümü adının önek bölümü. | XMLNode | |
| previousSibling : XMLNode
Üst düğümün alt listesindeki bir önceki eş öğeye başvuran bir XMLNode değeri. | XMLNode | |
| xmlDecl : Object = null
Bir belgenin XML bildirimi hakkında bilgi belirten dize. | XMLDocument | ||
| Yöntem | Tanımlayan: | ||
|---|---|---|---|
XMLDocument(source:String = null)
Yeni XMLDocument nesnesi oluşturur. | XMLDocument | ||
|
Belirtilen düğümü XML nesnesinin alt öğe listesine ekler. | XMLNode | |
|
Belirtilen XML nesnesi ile aynı tür, ad, değer ve niteliklere sahip yeni bir XML düğümü oluşturur. | XMLNode | |
Parametrede belirtilen ad ile yeni bir XMLNode nesnesi oluşturur. | XMLDocument | ||
Belirtilen metin ile yeni bir XML metin düğümü oluşturur. | XMLDocument | ||
|
Düğüm için belirtilen önekle ilişkili ad alanı URI'sini döndürür. | XMLNode | |
|
Düğüm için belirtilen ad alanı URI'si ile ilişkili öneki döndürür. | XMLNode | |
|
Belirtilen XMLNode nesnesinin alt düğümleri olup olmadığını gösterir. | XMLNode | |
|
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir. | Object | |
|
XML nesnesinin alt öğe listesine, beforeNode düğümünden önce yeni bir alt düğüm ekler. | XMLNode | |
|
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir. | Object | |
Değer parametresinde belirtilen XML metnini ayrıştırır ve belirtilen XMLDocument nesnesini nihai XML ağacı ile doldurur. | XMLDocument | ||
|
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir. | Object | |
|
Belirtilen XML nesnesini üst öğesinden çıkarır. | XMLNode | |
|
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar. | Object | |
|
Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür. | Object | |
[geçersiz kıl]
XML nesnesinin dize olarak temsilini döndürür. | XMLDocument | ||
|
Belirtilen nesnenin temel değerini döndürür. | Object | |
docTypeDecl | özellik |
public var docTypeDecl:Object = null| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
XML belgesinin DOCTYPE bildirimi hakkındaki bilgileri belirtir. XML metni bir XMLDocument nesnesi içinde ayrıştırıldıktan sonra XMLDocument nesnesinin XMLDocument.docTypeDecl özelliği, XML belgesinin DOCTYPE bildiriminin (örneğin, <!DOCTYPE greeting SYSTEM "hello.dtd">) metnine ayarlanır. Bu özellik, XMLNode nesnesini değil, DOCTYPE bildiriminin bir dize temsilini kullanarak ayarlanır.
Eski ActionScript XML ayrıştırıcısı, onaylayan bir ayrıştırıcı değildir. DOCTYPE bildirimi, ayrıştırıcı tarafından okunur ve XMLDocument.docTypeDecl özelliği içinde saklanır, ancak DTD onaylama işlemi gerçekleştirilir.
Bir ayrıştırma işlemi sırasında hiçbir DOCTYPE bildirimiyle karşılaşılmazsa, XMLDocument.docTypeDecl özelliği null olarak ayarlanır. XML.toString() yöntemi, XML.docTypeDecl öğesinin içeriğini, XML bildirimi XML.xmlDecl içinde saklandıktan hemen sonra ve XML nesnesindeki diğer bir metinden önce çıktı olarak verir. XMLDocument.docTypeDecl null ise, DOCTYPE bildirimleri çıktı olarak verilmez.
idMap | özellik |
public var idMap:Object| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
id niteliği atanmış XML'in düğümlerini içeren Object. Nesne özelliklerinin adları (her biri bir düğüm içerir), id niteliklerinin değerleriyle eşleşir.
Şu XMLDocument nesnesini göz önünde bulundurun:
<employee id='41'>
<name>
John Doe
</name>
<address>
601 Townsend St.
</address>
</employee>
<employee id='42'>
<name>
Jane Q. Public
</name>
</employee>
<department id="IT">
Information Technology
</department>
Bu örnekte, bu XMLDocument nesnesinin idMapözelliği, üç özelliğe sahip bir Object nesnesidir: 41, 42 ve IT. Bu özelliklerden her biri, eşleşen id değerine sahip bir XMLNode olur. Örneğin, idMap nesnesinin IT özelliği şu düğümdür:
<department id="IT">
Information Technology
</department>
Başlatılacak olan idMap özelliği için XMLDocument nesnesi üzerindeki parseXML() yöntemini kullanmalısınız.
Aynı id değerine sahip birden fazla XMLNode varsa, idNode nesnesinin eşleşen özelliği, ayrıştırılmış en son düğümün özelliğidir. Örneğin:
var x1:XML = new XMLDocument("<a id='1'><b id='2' /><c id='1' /></a>");
x2 = new XMLDocument();
x2.parseXML(x1);
trace(x2.idMap['1']);
<c> düğümünü çıktı olarak verir:
<c id='1' />
ignoreWhite | özellik |
public var ignoreWhite:Boolean = false| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
true olarak ayarlandığında, yalnızca beyaz boşluk içeren metin düğümleri ayrıştırma işlemi sırasında atılır. Satır aralığına ve izleyen beyaz boşluğa sahip metin düğümleri etkilenmez. Varsayılan ayar, false olur.
ignoreWhiteözelliğini ayrı ayrı XMLDocument nesneleri için, şu kodun gösterdiği şekilde ayarlayabilirsiniz:
my_xml.ignoreWhite = true;
xmlDecl | özellik |
public var xmlDecl:Object = null| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Bir belgenin XML bildirimi hakkında bilgi belirten dize. Bir XML belgesi, XMLDocument nesnesine ayrıştırıldığında bu özellik, belgenin XML bildiriminin metnine ayarlanır. Bu özellik, XMLNode nesnesini değil, XML bildiriminin bir dize temsilini kullanarak ayarlanır. Ayrıştırma işlemi sırasında XML bildirimiyle karşılaşılmazsa, özellik null olarak ayarlanır. XMLDocument.toString()yöntemi, XML.xmlDecl özelliğinin içeriğini XML nesnesindeki diğer metinlerden önce çıktı olarak verir. XML.xmlDecl özelliği null içeriyorsa, hiçbir XML bildirimi çıktı olarak verilmez.
XMLDocument | () | Yapıcı |
public function XMLDocument(source:String = null)| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Yeni XMLDocument nesnesi oluşturur. Herhangi bir XMLDocument sınıfı yöntemi çağırmadan önce XMLDocument nesnesi oluşturmak için yapıcıyı kullanmanız gerekir.
Not: Bir XML belgesi ağacına öğe ve metin düğümleri eklemek için createElement() ve createTextNode() yöntemlerini kullanın.
source:String (default = null) |
İlgili API Öğeleri
createElement | () | yöntem |
public function createElement(name:String):XMLNode| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Parametrede belirtilen ad ile yeni bir XMLNode nesnesi oluşturur. Yeni düğüm ilk başta üst, alt ve eş öğelere sahip olmaz. Yöntem, öğeyi temsil eden, yeni oluşturulmuş XMLNode nesnesine bir başvuru döndürür. Bu yöntem ve XMLDocument.createTextNode() yöntemi, bir XMLDocument nesnesi için düğüm oluşturma işlemi için yapıcı yöntemleridir.
Parametreler
name:String — Oluşturulan XMLDocument öğesinin etiket adı.
|
XMLNode — XMLNode nesnesi.
|
İlgili API Öğeleri
createTextNode | () | yöntem |
public function createTextNode(text:String):XMLNode| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Belirtilen metin ile yeni bir XML metin düğümü oluşturur. Yeni düğüm ilk başta üst öğeye sahip olmaz, metin düğümleri de alt veya eş öğelere sahip olamaz. Bu yöntem, yeni metin düğümünü temsil eden XMLDocument nesnesine bir başvuru döndürür. Bu yöntem ve XMLDocument.createElement() yöntemi, bir XMLDocument nesnesi için düğüm oluşturma işlemi için yapıcı yöntemleridir.
Parametreler
text:String — Yeni metin düğümünü oluşturmak için kullanılan metin.
|
XMLNode — XMLNode nesnesi.
|
İlgili API Öğeleri
parseXML | () | yöntem |
public function parseXML(source:String):void| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
value parametresinde belirtilen XML metnini ayrıştırır ve belirtilen XMLDocument nesnesini nihai XML ağacı ile doldurur. XMLDocument nesnesinde bulunan tüm ağaçlar atılır.
Parametreler
source:String — Belirtilen XMLDocument nesnesine iletilecek ve ayrıştırılacak olan XML metni.
|
toString | () | yöntem |
package {
import flash.display.Sprite;
import flash.xml.XMLDocument;
import flash.xml.XMLNode;
import flash.xml.XMLNodeType;
public class XMLDocumentExample extends Sprite {
public function XMLDocumentExample() {
var result:XMLDocument = new XMLDocument();
result.ignoreWhite = true;
result.parseXML(getXMLString());
var books:Array = parseBooks(result.firstChild);
trace("books: \n" + books);
}
private function parseBooks(node:XMLNode):Array {
var books:Array = new Array();
var kids:Array = node.childNodes;
for each(var item:XMLNode in kids) {
parseBook(item, books);
}
return books;
}
private function parseBook(node:XMLNode, books:Array):void {
var item:Book = new Book();
item.setPublisher(node.attributes.publisher);
item.setName(node.attributes.name);
books.push(item);
}
private function getXMLString():String {
var list:XML = <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>;
return list.toXMLString();
}
}
}
class Book {
private var publisher:String;
private var name:String;
public function setPublisher(publisher:String):void {
this.publisher = publisher;
}
public function setName(name:String):void {
this.name = name;
}
public function toString():String {
return "[Book name: " + name + " publisher: " + publisher + "]\n";
}
}
Tue Jun 12 2018, 01:09 PM Z