使用 toXMLString()
方法可返回 XML 对象的字符串表示形式,不管该 XML 对象具有简单内容还是复杂内容。
属性 | 定义方 | ||
---|---|---|---|
constructor : Object
对类对象或给定对象实例的构造函数的引用。
| Object | ||
ignoreComments : Boolean
[] 确定当 XML 对象分析源 XML 数据时,是否忽略 XML 注释。
| XML | ||
ignoreProcessingInstructions : Boolean
[] 确定当 XML 对象分析源 XML 数据时,是否忽略 XML 处理指令。
| XML | ||
ignoreWhitespace : Boolean
[] 确定分析期间是否忽略文本节点开头和末尾处的空白字符。
| XML | ||
prettyIndent : int
[] 确定当 XML.prettyPrinting 属性设置为 true 时,toString() 和 toXMLString() 方法所应用的缩进量。
| XML | ||
prettyPrinting : Boolean
[] 确定 toString() 和 toXMLString() 方法是否对某些标签之间的空白字符进行规格化。
| XML | ||
prototype : Object
[] 对类或函数对象的原型对象的引用。
| Object |
方法 | 定义方 | ||
---|---|---|---|
创建一个新的 XML 对象。
| XML | ||
可将命名空间添加到该 XML 对象所在范围的命名空间集中。
| XML | ||
将给定子项追加到该 XML 对象属性的末尾。
| XML | ||
返回其名称与 attributeName 参数相符的属性的 XML 值。
| XML | ||
返回给定 XML 对象的属性值列表。
| XML | ||
列出 XML 对象的子项。
| XML | ||
childIndex():
int
确定该 XML 对象在其父项上下文中从 0 开始编制索引的位置。
| XML | ||
按 XML 对象的显示顺序列出其子项。
| XML | ||
列出包含 XML 注释的 XML 对象的属性。
| XML | ||
对比该 XML 对象与给定 value 参数。
| XML | ||
返回给定 XML 对象的副本。
| XML | ||
[] 返回一个下列属性设置为默认值的对象:ignoreComments、ignoreProcessingInstructions、ignoreWhitespace、prettyIndent 和 prettyPrinting。
| XML | ||
返回包含给定 name 参数的 XML 对象的所有后代(子级、孙级、曾孙级等)。
| XML | ||
列出某 XML 对象的元素。
| XML | ||
检查该 XML 对象是否包含复杂内容。
| XML | ||
检查该对象是否具有 p 参数所指定的属性。
| XML | ||
检查该 XML 对象是否包含简单内容。
| XML | ||
根据该 XML 对象的父项列出其命名空间。
| XML | ||
在该 XML 对象的 child1 参数后插入给定的 child2 参数并返回生成的对象。
| XML | ||
在该 XML 对象的 child1 参数前插入给定的 child2 参数并返回生成的对象。
| XML | ||
指示 Object 类的实例是否在指定为参数的对象的原型链中。
| Object | ||
对于 XML 对象,该方法始终返回整数 1。
| XML | ||
提供该 XML 对象限定名称的本地名称部分。
| XML | ||
提供该 XML 对象的限定名称。
| XML | ||
如果没有提供参数,则提供与该 XML 对象的限定名关联的命名空间。
| XML | ||
在该 XML 对象的父项中列出与其关联的命名空间声明。
| XML | ||
指定节点的类型:文本、注释、处理指令、属性或元素。
| XML | ||
对于该 XML 对象以及所有子级 XML 对象,合并相邻文本节点并删除空文本节点。
| XML | ||
返回 XML 对象的父项。
| XML | ||
将提供的 child 对象的副本插入 XML 元素中,并放在该元素的任何现有 XML 属性前面。
| XML | ||
如果提供了 name 参数,则列出 XML 对象中包含带有该 name 的处理指令的所有子项。
| XML | ||
检查属性 p 所在的属性集是否可在应用于 XMLList 对象的 for..in 语句中遍历。
| XML | ||
删除该对象及其所有子级的给定命名空间。
| XML | ||
用给定的 value 参数替换 propertyName 参数所指定的属性。
| XML | ||
用 value 参数中提供的指定 XML 属性集替换该 XML 对象的子属性。
| XML | ||
将该 XML 对象的本地名称更改为给定的 name 参数。
| XML | ||
将该 XML 对象的名称设置为给定限定名称或属性名。
| XML | ||
设置与该 XML 对象关联的命名空间。
| XML | ||
设置循环操作动态属性的可用性。
| Object | ||
[] 设置下列 XML 属性的值:ignoreComments、ignoreProcessingInstructions、ignoreWhitespace、prettyIndent 和 prettyPrinting。
| XML | ||
[] 检索下列属性:ignoreComments、ignoreProcessingInstructions、ignoreWhitespace、prettyIndent 和 prettyPrinting。
| XML | ||
返回 XML 对象用来表示 XML 文本节点的所有 XML 属性的 XMLList 对象。
| XML | ||
返回 XML 对象的字符串表示形式。
| XML | ||
返回 XML 对象的字符串表示形式。
| XML | ||
返回该 XML 对象。
| XML |
ignoreComments | 属性 |
ignoreComments:Boolean
[]
语言版本 : | ActionScript 3.0 |
RuntimeVersions: | AIR 1.0, Flash Player 9 |
确定当 XML 对象分析源 XML 数据时,是否忽略 XML 注释。默认情况下,将忽略注释 (true
)。若要包括 XML 注释,请将此属性设置为 false
。ignoreComments
属性仅在 XML 分析过程中使用,而不能在调用任何方法(例如,myXMLObject.child(*).toXMLString()
)时使用。如果源 XML 包含注释节点,可在 XML 分析过程中保留或丢弃这些节点。
实现
public static function get ignoreComments():Boolean
public function set ignoreComments(value:Boolean):void
另请参见
示例
XML.ignoreComments
设置为
false
以及设置为
true
的效果:
XML.ignoreComments = false; var xml1:XML = <foo> <!-- comment --> </foo>; trace(xml1.toXMLString()); // <foo><!-- comment --></foo> XML.ignoreComments = true; var xml2:XML = <foo> <!-- example --> </foo>; trace(xml2.toXMLString()); // <foo/>
ignoreProcessingInstructions | 属性 |
ignoreProcessingInstructions:Boolean
[]
语言版本 : | ActionScript 3.0 |
RuntimeVersions: | AIR 1.0, Flash Player 9 |
确定当 XML 对象分析源 XML 数据时,是否忽略 XML 处理指令。默认情况下,将忽略处理指令 (true
)。若要包括 XML 处理指令,请将此属性设置为 false
。ignoreProcessingInstructions
属性仅在 XML 分析过程中使用,而不能在调用任何方法(例如,myXMLObject.child(*).toXMLString()
)时使用。如果源 XML 包含处理指令节点,可在 XML 分析过程中保留或丢弃这些节点。
实现
public static function get ignoreProcessingInstructions():Boolean
public function set ignoreProcessingInstructions(value:Boolean):void
另请参见
示例
XML.ignoreProcessingInstructions
设置为
false
以及设置为
true
的效果:
XML.ignoreProcessingInstructions = false; var xml1:XML = <foo> <?exampleInstruction ?> </foo>; trace(xml1.toXMLString()); // <foo><?exampleInstruction ?></foo> XML.ignoreProcessingInstructions = true; var xml2:XML = <foo> <?exampleInstruction ?> </foo>; trace(xml2.toXMLString()); // <foo/>
ignoreWhitespace | 属性 |
ignoreWhitespace:Boolean
[]
语言版本 : | ActionScript 3.0 |
RuntimeVersions: | AIR 1.0, Flash Player 9 |
确定分析期间是否忽略文本节点开头和末尾处的空白字符。默认情况下,将忽略空白 (true
)。如果文本节点 100% 是空白,且 ignoreWhitespace
属性设置为 true
,则不会创建该节点。若要显示文本节点中的空白,请将 ignoreWhitespace
属性设置为 false
。
实现
public static function get ignoreWhitespace():Boolean
public function set ignoreWhitespace(value:Boolean):void
示例
XML.ignoreWhitespace
设置为
false
以及设置为
true
的效果:
XML.ignoreWhitespace = false; var xml1:XML = <foo> </foo>; trace(xml1.children().length()); // 1 XML.ignoreWhitespace = true; var xml2:XML = <foo> </foo>; trace(xml2.children().length()); // 0
prettyIndent | 属性 |
prettyIndent:int
[]
语言版本 : | ActionScript 3.0 |
RuntimeVersions: | AIR 1.0, Flash Player 9 |
确定当 XML.prettyPrinting
属性设置为 true
时,toString()
和 toXMLString()
方法所应用的缩进量。应用缩进时使用空格字符,而不是制表符。默认值为 2
。
实现
public static function get prettyIndent():int
public function set prettyIndent(value:int):void
另请参见
示例
XML.prettyIndent
静态属性的效果:
var xml:XML = <foo><bar/></foo>; XML.prettyIndent = 0; trace(xml.toXMLString()); XML.prettyIndent = 1; trace(xml.toXMLString()); XML.prettyIndent = 2; trace(xml.toXMLString());
prettyPrinting | 属性 |
prettyPrinting:Boolean
[]
语言版本 : | ActionScript 3.0 |
RuntimeVersions: | AIR 1.0, Flash Player 9 |
确定 toString()
和 toXMLString()
方法是否对某些标签之间的空白字符进行规格化。默认值为 true
。
实现
public static function get prettyPrinting():Boolean
public function set prettyPrinting(value:Boolean):void
另请参见
示例
XML.prettyPrinting
静态属性的效果:
var xml:XML = <foo><bar/></foo>; XML.prettyPrinting = false; trace(xml.toXMLString()); XML.prettyPrinting = true; trace(xml.toXMLString());
XML | () | 构造函数 |
public function XML(value:Object)
语言版本 : | ActionScript 3.0 |
RuntimeVersions: | AIR 1.0, Flash Player 9 |
创建一个新的 XML 对象。调用 XML 类的方法之前,必须使用该构造函数创建一个 XML 对象。
使用 toXMLString()
方法可返回 XML 对象的字符串表示形式,不管该 XML 对象具有简单内容还是复杂内容。
参数
value:Object — 可通过顶级 XML() 函数转换为 XML 的任意对象。 |
另请参见
XML.toXMLString()
addNamespace | () | 方法 |
AS3 function addNamespace(ns:Object):XML
语言版本 : | ActionScript 3.0 |
RuntimeVersions: | AIR 1.0, Flash Player 9 |
可将命名空间添加到该 XML 对象所在范围的命名空间集中。如果 XML 对象(其前缀与给定参数的前缀匹配)所在范围的命名空间中已存在该命名空间,则现有命名空间的前缀将设置为 undefined
。如果输入参数是一个 Namespace 对象,则直接使用该参数。如果它是一个 QName 对象,则使用输入参数的 URI 创建新的命名空间;否则,会将它转换为一个 String 值并根据该 String 值创建命名空间。
参数
ns:Object — 要添加到 XML 对象中的命名空间。 |
返回
XML — 添加了命名空间的新 XML 对象。 |
另请参见
appendChild | () | 方法 |
AS3 function appendChild(child:Object):XML
语言版本 : | ActionScript 3.0 |
RuntimeVersions: | AIR 1.0, Flash Player 9 |
将给定子项追加到该 XML 对象属性的末尾。appendChild()
方法可采用 XML 对象、XMLList 对象或随后转换为 String 的任何其它数据类型。
使用 delete
(XML) 运算符删除 XML 节点。
参数
child:Object — 要追加的 XML 对象。 |
返回
XML — 生成的 XML 对象。 |
另请参见
attribute | () | 方法 |
AS3 function attribute(attributeName:*):XMLList
语言版本 : | ActionScript 3.0 |
RuntimeVersions: | AIR 1.0, Flash Player 9 |
返回其名称与 attributeName
参数相符的属性的 XML 值。可在 XML 元素内找到属性。在以下示例中,元素具有名为“gender
”的属性,其值为“boy
”:<first gender="boy">John</first>
。
attributeName
参数可以是任何数据类型;但 String 是最常用的数据类型。在传递 QName 对象之外的任何对象时,attributeName
参数会使用 toString()
方法将参数转换为字符串。
如果需要一个限定名称引用,可以传入 QName 对象。QName 对象可定义命名空间和本地名称,还可定义属性的限定名称。因此,调用 attribute(qname)
不同于调用 attribute(qname.toString())
。
参数
attributeName:* — 属性的名称。 |
返回
XMLList — 一个 XMLList 对象或空的 XMLList 对象。在未定义属性值时返回一个空的 XMLList 对象。 |
另请参见
QName
Namespace
XML.elements()
http://www.cnblogs.com/wenjl520/admin/mk:@MSITStore:E:\DesktopFile\知识库\Flex\Flex.3API文档.chm::/operators.html#attribute_identifier
本示例演示如何将 QName 对象传递给
attribute()
方法。
localName
属性为
attr
,
namespace
属性为
ns
。
var xml:XML = <ns:node xmlns:ns = "http://uri" ns:attr = '7' /> var qn:QName = new QName("http://uri", "attr"); trace(xml.attribute(qn)); // 7
attribute()
方法替代属性标识符 (@) 运算符,如下面的示例所示:
var xml:XML = <example class="first" /> trace(xml.attribute("class"));
attributes | () | 方法 |
AS3 function attributes():XMLList
语言版本 : | ActionScript 3.0 |
RuntimeVersions: | AIR 1.0, Flash Player 9 |
返回给定 XML 对象的属性值列表。结合使用 name()
方法和 attributes()
方法可返回属性的名称。使用 @*
可返回所有属性的名称。
返回
XMLList — 属性值的列表。 |
另请参见
XML.name()
@ operator
下面的示例返回属性的名称:
var xml:XML=<example id='123' color='blue'/> trace(xml.attributes()[1].name()); //color
var xml:XML = <example id='123' color='blue'/> var attNamesList:XMLList = xml.@*; trace(attNamesList is XMLList); // true trace(attNamesList.length()); // 2 for (var i:int = 0; i < attNamesList.length(); i++) { trace(typeof (attNamesList[i])); // xml trace(attNamesList[i].nodeKind()); // attribute trace(attNamesList[i].name()); // id and color }
child | () | 方法 |
AS3 function child(propertyName:Object):XMLList
语言版本 : | ActionScript 3.0 |
RuntimeVersions: | AIR 1.0, Flash Player 9 |
列出 XML 对象的子项。一个 XML 子项就是一个 XML 元素、文本节点、注释或处理指令。
使用 propertyName
参数可列出特定 XML 子项的内容。例如,若要返回名为 <first>
的子项的内容,可使用 child.name("first")
。使用子项的索引编号,可以生成相同的结果。索引编号标识该子项在其它 XML 子项列表中的位置。例如,name.child(0)
将返回列表中的第一个子项。
使用星号 (*) 可输出 XML 文档中的所有子项。例如,doc.child("*")
。
结合使用 length()
方法与 child()
方法的星号 (*) 参数可输出子项的总数。例如,numChildren = doc.child("*").length()
。
参数
propertyName:Object — XML 子对象的元素名称或整数。 |
返回
XMLList — 与输入参数匹配的子节点的 XMLList 对象。 |
另请参见
XMLList class
XML.length()
本示例演示如何使用
child()
方法识别具有指定名称的子元素:
var xml:XML = <foo> <bar>text1</bar> <bar>text2</bar> </foo>; trace(xml.child("bar").length()); // 2 trace(xml.child("bar")[0].toXMLString()); // <bar>text1</bar> trace(xml.child("bar")[1].toXMLString()); // <bar>text2</bar>
childIndex | () | 方法 |
AS3 function childIndex():int
语言版本 : | ActionScript 3.0 |
RuntimeVersions: | AIR 1.0, Flash Player 9 |
确定该 XML 对象在其父项上下文中从 0 开始编制索引的位置。
返回
int — 对象的位置。返回 -1 以及正整数。 |
另请参见
children | () | 方法 |
AS3 function children():XMLList
语言版本 : | ActionScript 3.0 |
RuntimeVersions: | AIR 1.0, Flash Player 9 |
按 XML 对象的显示顺序列出其子项。一个 XML 子项就是一个 XML 元素、文本节点、注释或处理指令。
返回
XMLList — XML 对象子项的 XMLList 对象。 |
另请参见
comments | () | 方法 |
AS3 function comments():XMLList
语言版本 : | ActionScript 3.0 |
RuntimeVersions: | AIR 1.0, Flash Player 9 |
列出包含 XML 注释的 XML 对象的属性。
返回
XMLList — 包含注释的属性的 XMLList 对象。 |
另请参见