博客
关于我
强烈建议你试试无所不能的chatGPT，快点击我
FLEX程序设计--XML类
阅读量：5879 次
发布时间：2019-06-19

本文共 22719 字，大约阅读时间需要 75 分钟。

XML 类包含用于处理 XML 对象的方法和属性。XML 类（以及 XMLList、Namespace 和 QName 类）可实现 ECMAScript for XML (E4X) 规范（ECMA-357 第 2 版）中定义的强大的 XML 处理标准。

使用 toXMLString() 方法可返回 XML 对象的字符串表示形式，不管该 XML 对象具有简单内容还是复杂内容。

 

公共属性
  属性 定义方
  Inherited :
对类对象或给定对象实例的构造函数的引用。
    :
[] 确定当 XML 对象分析源 XML 数据时，是否忽略 XML 注释。
XML
    :
[] 确定当 XML 对象分析源 XML 数据时，是否忽略 XML 处理指令。
XML
    :
[] 确定分析期间是否忽略文本节点开头和末尾处的空白字符。
XML
    :
[] 确定当 XML.prettyPrinting 属性设置为 true 时，toString() 和 toXMLString() 方法所应用的缩进量。
XML
    :
[] 确定 toString() 和 toXMLString() 方法是否对某些标签之间的空白字符进行规格化。
XML
  Inherited :
[] 对类或函数对象的原型对象的引用。

公共方法
  方法 定义方
   
(value: )
创建一个新的 XML 对象。
XML
   
(ns: ):
可将命名空间添加到该 XML 对象所在范围的命名空间集中。
XML
   
(child: ):
将给定子项追加到该 XML 对象属性的末尾。
XML
   
(attributeName: ):
返回其名称与 attributeName 参数相符的属性的 XML 值。
XML
   
():
返回给定 XML 对象的属性值列表。
XML
   
(propertyName: ):
列出 XML 对象的子项。
XML
   
():
确定该 XML 对象在其父项上下文中从 0 开始编制索引的位置。
XML
   
():
按 XML 对象的显示顺序列出其子项。
XML
   
():
列出包含 XML 注释的 XML 对象的属性。
XML
   
(value: ):
对比该 XML 对象与给定 value 参数。
XML
   
():
返回给定 XML 对象的副本。
XML
   
():
[] 返回一个下列属性设置为默认值的对象：ignoreComments、ignoreProcessingInstructions、ignoreWhitespace、prettyIndent 和 prettyPrinting。
XML
   
(name: = *):
返回包含给定 name 参数的 XML 对象的所有后代（子级、孙级、曾孙级等）。
XML
   
(name: = *):
列出某 XML 对象的元素。
XML
   
():
检查该 XML 对象是否包含复杂内容。
XML
   
(p: ):
检查该对象是否具有 p 参数所指定的属性。
XML
   
():
检查该 XML 对象是否包含简单内容。
XML
   
():
根据该 XML 对象的父项列出其命名空间。
XML
   
(child1: , child2: ):
在该 XML 对象的 child1 参数后插入给定的 child2 参数并返回生成的对象。
XML
   
(child1: , child2: ):
在该 XML 对象的 child1 参数前插入给定的 child2 参数并返回生成的对象。
XML
  Inherited
(theClass: ):
指示 Object 类的实例是否在指定为参数的对象的原型链中。
   
():
对于 XML 对象，该方法始终返回整数 1。
XML
   
():
提供该 XML 对象限定名称的本地名称部分。
XML
   
():
提供该 XML 对象的限定名称。
XML
   
(prefix: = null):
如果没有提供参数，则提供与该 XML 对象的限定名关联的命名空间。
XML
   
():
在该 XML 对象的父项中列出与其关联的命名空间声明。
XML
   
():
指定节点的类型：文本、注释、处理指令、属性或元素。
XML
   
():
对于该 XML 对象以及所有子级 XML 对象，合并相邻文本节点并删除空文本节点。
XML
   
():
返回 XML 对象的父项。
XML
   
(value: ):
将提供的 child 对象的副本插入 XML 元素中，并放在该元素的任何现有 XML 属性前面。
XML
   
(name: = "*"):
如果提供了 name 参数，则列出 XML 对象中包含带有该 name 的处理指令的所有子项。
XML
   
(p: ):
检查属性 p 所在的属性集是否可在应用于 XMLList 对象的 for..in 语句中遍历。
XML
   
(ns: ):
删除该对象及其所有子级的给定命名空间。
XML
   
(propertyName: , value: ):
用给定的 value 参数替换 propertyName 参数所指定的属性。
XML
   
(value: ):
用 value 参数中提供的指定 XML 属性集替换该 XML 对象的子属性。
XML
   
(name: ):
将该 XML 对象的本地名称更改为给定的 name 参数。
XML
   
(name: ):
将该 XML 对象的名称设置为给定限定名称或属性名。
XML
   
(ns: ):
设置与该 XML 对象关联的命名空间。
XML
  Inherited
(name: , isEnum: = true):
设置循环操作动态属性的可用性。
   
( rest):
[] 设置下列 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:  []

 

语言版本 :  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():
    public function set ignoreComments(value:):

另请参见

示例
本示例演示将
XML.ignoreComments 设置为
false 以及设置为
true 的效果： 
XML.ignoreComments = false;var xml1:XML =
          
           
          ;trace(xml1.toXMLString()); // 
          
           
          XML.ignoreComments = true;var xml2:XML =
          
           
          ;trace(xml2.toXMLString()); //
ignoreProcessingInstructions 属性  
ignoreProcessingInstructions:  []

 

语言版本 :  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():
    public function set ignoreProcessingInstructions(value:):

另请参见

示例
本示例演示将
XML.ignoreProcessingInstructions 设置为
false 以及设置为
true 的效果： 
XML.ignoreProcessingInstructions = false;var xml1:XML =
          
           
          ;trace(xml1.toXMLString()); // 
          
           
          XML.ignoreProcessingInstructions = true;var xml2:XML =
          
           
          ;trace(xml2.toXMLString()); //
ignoreWhitespace 属性  
ignoreWhitespace:  []

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

确定分析期间是否忽略文本节点开头和末尾处的空白字符。默认情况下，将忽略空白 (true)。如果文本节点 100% 是空白，且 ignoreWhitespace 属性设置为 true，则不会创建该节点。若要显示文本节点中的空白，请将 ignoreWhitespace 属性设置为 false。

实现
    public static function get ignoreWhitespace():
    public function set ignoreWhitespace(value:):
示例
本示例演示将
XML.ignoreWhitespace 设置为
false 以及设置为
true 的效果： 
XML.ignoreWhitespace = false;var xml1:XML = 
              
          ;trace(xml1.children().length()); // 1XML.ignoreWhitespace = true;var xml2:XML = 
              
          ;trace(xml2.children().length()); // 0
prettyIndent 属性  
prettyIndent:  []

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

确定当 XML.prettyPrinting 属性设置为 true 时，toString() 和 toXMLString() 方法所应用的缩进量。应用缩进时使用空格字符，而不是制表符。默认值为 2。

实现
    public static function get prettyIndent():
    public function set prettyIndent(value:):

另请参见

示例
本示例演示设置
XML.prettyIndent 静态属性的效果： 
var xml:XML = 
          
           
          ;XML.prettyIndent = 0;trace(xml.toXMLString());XML.prettyIndent = 1;trace(xml.toXMLString());XML.prettyIndent = 2;trace(xml.toXMLString());
prettyPrinting 属性  
prettyPrinting:  []

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

确定 toString() 和 toXMLString() 方法是否对某些标签之间的空白字符进行规格化。默认值为 true。

实现
    public static function get prettyPrinting():
    public function set prettyPrinting(value:):

另请参见

示例
本示例演示设置
XML.prettyPrinting 静态属性的效果： 
var xml:XML = 
          
           
          ;XML.prettyPrinting = false;trace(xml.toXMLString());XML.prettyPrinting = true;trace(xml.toXMLString());
构造函数详细信息
XML () 构造函数
public function XML(value:)

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

创建一个新的 XML 对象。调用 XML 类的方法之前，必须使用该构造函数创建一个 XML 对象。

使用 toXMLString() 方法可返回 XML 对象的字符串表示形式，不管该 XML 对象具有简单内容还是复杂内容。

 

参数
value: — 可通过顶级 XML() 函数转换为 XML 的任意对象。

另请参见

方法详细信息
addNamespace () 方法
function addNamespace(ns:):

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

可将命名空间添加到该 XML 对象所在范围的命名空间集中。如果 XML 对象（其前缀与给定参数的前缀匹配）所在范围的命名空间中已存在该命名空间，则现有命名空间的前缀将设置为 undefined。如果输入参数是一个 Namespace 对象，则直接使用该参数。如果它是一个 QName 对象，则使用输入参数的 URI 创建新的命名空间；否则，会将它转换为一个 String 值并根据该 String 值创建命名空间。

参数

ns: — 要添加到 XML 对象中的命名空间。

 

返回
— 添加了命名空间的新 XML 对象。

另请参见

appendChild () 方法  
function appendChild(child:):

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

将给定子项追加到该 XML 对象属性的末尾。appendChild() 方法可采用 XML 对象、XMLList 对象或随后转换为 String 的任何其它数据类型。

使用 delete (XML) 运算符删除 XML 节点。

 

参数

child: — 要追加的 XML 对象。

 

返回
— 生成的 XML 对象。

另请参见

attribute () 方法  
function attribute(attributeName:):

 

语言版本 :  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 对象。

另请参见

若要返回名称与 ActionScript 保留字匹配的属性，请使用
attribute() 方法替代属性标识符 (@) 运算符，如下面的示例所示： 
var xml:XML = 
            trace(xml.attribute("class"));
attributes () 方法  
function attributes():

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

返回给定 XML 对象的属性值列表。结合使用 name() 方法和 attributes() 方法可返回属性的名称。使用 @* 可返回所有属性的名称。

 

返回
— 属性值的列表。

另请参见

下面的示例返回所有属性的名称： 
var xml:XML = 
           var attNamesList:XMLList = xml.@*;trace(attNamesList is XMLList); // truetrace(attNamesList.length()); // 2for (var i:int = 0; i < attNamesList.length(); i++){trace(typeof (attNamesList[i])); // xmltrace(attNamesList[i].nodeKind()); // attributetrace(attNamesList[i].name()); // id and color}
child () 方法  
function child(propertyName:):

 

语言版本 :  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: — XML 子对象的元素名称或整数。

 

返回
— 与输入参数匹配的子节点的 XMLList 对象。

另请参见

childIndex () 方法  
function childIndex():

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

确定该 XML 对象在其父项上下文中从 0 开始编制索引的位置。

 

返回
— 对象的位置。返回 -1 以及正整数。

另请参见

children () 方法  
function children():

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

按 XML 对象的显示顺序列出其子项。一个 XML 子项就是一个 XML 元素、文本节点、注释或处理指令。

 

返回
— XML 对象子项的 XMLList 对象。

另请参见

comments () 方法  
function comments():

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

列出包含 XML 注释的 XML 对象的属性。

 

返回
— 包含注释的属性的 XMLList 对象。

另请参见

contains () 方法  
function contains(value:):

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

对比该 XML 对象与给定 value 参数。

参数

value: — 要与当前 XML 对象进行对比的值。

 

返回
— 如果 XML 对象与 value 参数匹配，则为 true；否则为 false。

另请参见

copy () 方法  
function copy():

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

返回给定 XML 对象的副本。该副本为整个节点树的副本。复制的 XML 对象没有父级，如果尝试调用 parent() 方法，将返回 null。

 

返回
— 对象的副本。

另请参见

defaultSettings () 方法  
static function defaultSettings():

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

返回一个下列属性设置为默认值的对象：ignoreComments、ignoreProcessingInstructions、ignoreWhitespace、prettyIndent 和 prettyPrinting。其默认值如下：

  • ignoreComments = true
  • ignoreProcessingInstructions = true
  • ignoreWhitespace = true
  • prettyIndent = 2
  • prettyPrinting = true

注意：不要将此方法应用于 XML 类的实例；应将其应用于 XML，如以下代码所示：var df:Object = XML.defaultSettings()。

 

 

返回
— 属性设置为默认设置的对象。

另请参见

descendants () 方法  
function descendants(name: = *):

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

返回包含给定 name 参数的 XML 对象的所有后代（子级、孙级、曾孙级等）。name 参数是可选项。name 参数可以为 QName 对象、String 数据类型或随后转换为 String 数据类型的任何其它数据类型。

若要返回所有后代，请使用“*”参数。如果未传递任何参数，则传递字符串“*”，并返回此 XML 对象的所有后代。

 

参数

name: (default = *) — 要匹配的元素的名称。

 

返回
— 匹配后代的 XMLList 对象。如果没有后代，则返回空的 XMLList 对象。

另请参见

示例
若要返回名称与 ActionScript 保留字相匹配的后代，请使用
descendants() 方法，而不要使用后代运算符 (..)， 运算符，如下面的示例所示： 
var xml:XML =
      
       
        
        
       
       
        
        
       
      trace(xml.descendants("class"));
下面的示例演示
descendants() 方法如何返回包含
所有后代对象（包括子级、孙级等）的 XMLList 对象： 
XML.ignoreComments = false;var xml:XML =
      text1text2;trace(xml.descendants("*").length()); // 5trace(xml.descendants("*")[0]); // // 
      trace(xml.descendants("*")[1].toXMLString()); // text1trace(xml.descendants("a").toXMLString()); // text2trace(xml.descendants("b").toXMLString()); // text2
elements () 方法  
function elements(name: = *):

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

列出某 XML 对象的元素。一个由开始和结束标签组成的元素；例如 <first></first>。name 参数是可选项。name 参数可以为 QName 对象、String 数据类型或随后转换为 String 数据类型的任何其它数据类型。使用 name 参数可列出特定元素。例如，以下示例中的元素“first”返回“John”：<first>John</first>。

若要列出所有元素，请使用星号 (*) 作为参数。该星号也是默认参数。

使用带星号参数的 length() 方法可输出元素的总数。例如，numElement = addressbook.elements("*").length()。

 

参数

name: (default = *) — 元素的名称。元素的名称由尖括号括起。例如，以下示例中的“first”为 name：<first></first>。

 

返回
— 元素内容的 XMLList 对象。元素内容位于起始和结束标签之间。如果使用星号 (*) 调用所有元素，将返回元素的标签和内容。

另请参见

若要返回名称与 ActionScript 保留字相匹配的元素，请使用
elements() 方法替代 XML 点 (.) 运算符，如下面的示例所示： 
var xml:XML =
      
       
       
      trace(xml.elements("class"));
hasComplexContent () 方法  
function hasComplexContent():

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

检查该 XML 对象是否包含复杂内容。如果 XML 对象具有子元素，则表明它包含复杂内容。表示属性、注释、处理指令和文本节点的 XML 对象不包含复杂内容。但是，仍可将包含上述内容的对象视为包含复杂内容（条件是该对象具有子元素）。

 

返回
— 如果 XML 对象包含复杂内容，则为 true，否则为 false。

另请参见

hasOwnProperty () 方法  
function hasOwnProperty(p:):

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

检查该对象是否具有 p 参数所指定的属性。

参数

p: — 要匹配的属性。

 

返回
— 如果此属性存在，则为 true；否则为 false。

另请参见

下例使用
hasOwnProperty() 方法，以确保属性 (
item) 在计算使用该属性的表达式 (
item.contains("toothbrush")) 之前便已存在： 
var xml:XML =
      
       
        
         toothbrush
        
        
         toothpaste
        
       
       
        
         shoe polish
        
       
      ;trace(xml.order.(hasOwnProperty("item") && item.contains("toothbrush")));
hasSimpleContent () 方法  
function hasSimpleContent():

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

检查该 XML 对象是否包含简单内容。如果 XML 对象表示文本节点、属性节点或不包含子元素的 XML 元素，则表明它包含简单内容。表示注释和处理指令的 XML 对象不包含简单内容。

 

返回
— 如果 XML 对象包含简单内容，则为 true，否则为 false。

另请参见

inScopeNamespaces () 方法  
function inScopeNamespaces():

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

根据该 XML 对象的父项列出其命名空间。

 

返回
— Namespace 对象的数组。

另请参见

insertChildAfter () 方法  
function insertChildAfter(child1:, child2:):

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

在该 XML 对象的 child1 参数后插入给定的 child2 参数并返回生成的对象。如果 child1 参数为 null，则该方法将在 XML 对象的所有子项之前 插入 child2 的内容（也就是说，不 在任何子项之后）。如果提供 child1，但 XML 对象中不包含该参数，则不修改该 XML 对象并返回 undefined。

如果对不是元素（文本、属性、注释、pi 等等）的 XML 子项调用该方法，则返回 undefined。

使用 delete (XML) 运算符删除 XML 节点。

 

参数

child1: — 在 child2 之前插入的源对象中的对象。
 
child2: — 要插入的对象。

 

返回
— 生成的 XML 对象或 undefined。

另请参见

insertChildBefore () 方法  
function insertChildBefore(child1:, child2:):

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

在该 XML 对象的 child1 参数前插入给定的 child2 参数并返回生成的对象。如果 child1 参数为 null，则该方法将在 XML 对象的所有子项之后 插入 child2 的内容（也就是说，不 在任何子项之前）。如果提供 child1，但 XML 对象中不包含该参数，则不修改该 XML 对象并返回 undefined。

如果对不是元素（文本、属性、注释、pi 等等）的 XML 子项调用该方法，则返回 undefined。

使用 delete (XML) 运算符删除 XML 节点。

 

参数

child1: — 在 child2 之后插入的源对象中的对象。
 
child2: — 要插入的对象。

 

返回
— 生成的 XML 对象或 undefined。

另请参见

length () 方法  
function length():

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

对于 XML 对象，该方法始终返回整数 1。XMLList 类的 length() 方法对仅包含一个值的 XMLList 对象返回值 1。

 

返回
— 对于任何 XML 对象，始终返回 1。

另请参见

localName () 方法  
function localName():

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

提供该 XML 对象限定名称的本地名称部分。

 

返回
— 作为 String 或 null 的本地名称。

另请参见

name () 方法  
function name():

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

提供该 XML 对象的限定名称。

 

返回
— 限定名称为 QName 或 null。

另请参见

下面的示例演示如何对 XML 属性 (property)、文本元素和属性 (attribute) 调用
name() 方法： 
var xml:XML =
       
        text
       ;trace(xml.name().localName); // footrace(xml.name().uri == ""); // truetrace(xml.children()[0]); // texttrace(xml.children()[0].name()); // nulltrace(xml.attributes()[0]); // 15trace(xml.attributes()[0].name()); // x
namespace () 方法  
function namespace(prefix: = null):

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

如果没有提供参数，则提供与该 XML 对象的限定名关联的命名空间。如果指定了 prefix 参数，则该方法将返回与 prefix 参数匹配且位于 XML 对象所在范围内的命名空间。如果不存在此类命名空间，该方法将返回 undefined。

参数

prefix: (default = null) — 要匹配的前缀。

 

返回
— 返回 null、undefined 或命名空间。

另请参见

下例使用
namespace() 方法获取节点的默认命名空间，以及特定前缀 (
"dc") 的命名空间： 
var xml:XML =
       
        
       ;trace(xml.namespace()); // http://www.w3.org/1999/02/22-rdf-syntax-ns#trace(xml.namespace("dc")); // http://purl.org/dc/elements/1.1/trace(xml.namespace("foo")); // undefined
namespaceDeclarations () 方法  
function namespaceDeclarations():

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

在该 XML 对象的父项中列出与其关联的命名空间声明。

 

返回
— Namespace 对象的数组。

另请参见

nodeKind () 方法  
function nodeKind():

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

指定节点的类型：文本、注释、处理指令、属性或元素。

 

返回
— 所使用的节点类型。

另请参见

normalize () 方法  
function normalize():

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

对于该 XML 对象以及所有子级 XML 对象，合并相邻文本节点并删除空文本节点。

 

返回
— 生成的标准 XML 对象。

另请参见

parent () 方法  
function parent():

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

返回 XML 对象的父项。如果该 XML 对象没有父项，则该方法返回 undefined。

 

返回
— 父 XML 对象。返回 String 或 null。

另请参见

prependChild () 方法  
function prependChild(value:):

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

将提供的 child 对象的副本插入 XML 元素中，并放在该元素的任何现有 XML 属性前面。

使用 delete (XML) 运算符删除 XML 节点。

 

参数

value: — 要插入的对象。

 

返回
— 生成的 XML 对象。

另请参见

processingInstructions () 方法  
function processingInstructions(name: = "*"):

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

如果提供 name 参数，则列出包含该 name 的处理指令的 XML 对象的所有子项。如果未提供参数，则该方法会列出包含任何处理指令的 XML 对象的所有子项。

参数

name: (default = "*") — 要匹配的处理指令的名称。

 

返回
— 匹配的子对象的列表。

另请参见

propertyIsEnumerable () 方法  
function propertyIsEnumerable(p:):

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

检查属性 p 所在的属性集是否可在应用于 XMLList 对象的 for..in 语句中遍历。仅当 toString(p) == "0" 时返回 true。

参数

p: — 要检查的属性。

 

返回
— 如果该属性可以在 for..in 语句中，为 true；否则为 false。

另请参见

removeNamespace () 方法  
function removeNamespace(ns:):

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

删除该对象及其所有子级的给定命名空间。如果命名空间由该对象的限定名称或该对象属性的限定名称引用，则 removeNamespace() 方法不会删除该命名空间。

参数

ns: — 要删除的命名空间。

 

返回
— 生成的 XML 对象的副本。

另请参见

replace () 方法  
function replace(propertyName:, value:):

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

用给定的 value 参数替换 propertyName 参数所指定的属性。如果没有属性与 propertyName 匹配，会将 XML 对象保持为未修改状态。

参数

propertyName: — 可以是数值、XML 元素集的非限定名称、XML 元素集的限定名称或星号通配符 (*)。使用非限定名称标识默认命名空间中的 XML 元素。
 
value: — 替换值。它可以是 XML 对象、XMLList 对象或可以使用 toString() 转换的任何值。

 

返回
— 生成的 XML 对象，其中替换了匹配属性。

另请参见

下面的示例调用
replace() 方法时将字符串作为第一个参数： 
var xml:XML =
Hello
World
      
;xml.replace("p", 
Hi
);trace(xml);
这将产生以下
trace() 输出： 
Hi
     
;
下面的示例演示在调用
replace() 方法时将 QName 作为第一个参数： 
var xml:XML =
      
       
        Hello
       
       
        World
       
       
      ;var qname:QName = new QName("myNS", "p");xml.replace(qname, 
Bob
);trace(xml);
这将产生以下
trace() 输出： 
     
      
Bob
下面的示例演示在调用
replace() 方法时将字符串
"*" 作为第一个参数： 
var xml:XML =
Hello
World
      
;xml.replace("*", );trace(xml);
这将产生以下
trace() 输出：
setChildren () 方法  
function setChildren(value:):

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

用 value 参数中提供的指定 XML 属性集替换该 XML 对象的子属性。

参数

value: — 替换 XML 属性。可以是单个 XML 对象或 XMLList 对象。

 

返回
— 生成的 XML 对象。

另请参见

setLocalName () 方法  
function setLocalName(name:):

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

将该 XML 对象的本地名称更改为给定的 name 参数。

参数

name: — 本地名称的替换名称。

另请参见

setName () 方法  
function setName(name:):

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

将该 XML 对象的名称设置为给定限定名称或属性名。

参数

name: — 对象的新名称。

另请参见

setNamespace () 方法  
function setNamespace(ns:):

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

设置与该 XML 对象关联的命名空间。

参数

ns: — 新命名空间。

另请参见

setSettings () 方法  
static function setSettings( rest):

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

设置下列 XML 属性的值：ignoreComments、ignoreProcessingInstructions、ignoreWhitespace、prettyIndent 和 prettyPrinting。以下是默认设置，如果未提供 setObj 参数，将应用这些设置：

  • XML.ignoreComments = true
  • XML.ignoreProcessingInstructions = true
  • XML.ignoreWhitespace = true
  • XML.prettyIndent = 2
  • XML.prettyPrinting = true

注意：不要将此方法应用于 XML 类的实例；应将其应用于 XML，如以下代码所示：XML.setSettings()。

 

参数

rest — 具有下列各个属性的对象：
  • ignoreComments
  • ignoreProcessingInstructions
  • ignoreWhitespace
  • prettyIndent
  • prettyPrinting

另请参见

settings () 方法  
static function settings():

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

检索下列属性：ignoreComments、ignoreProcessingInstructions、ignoreWhitespace、prettyIndent 和 prettyPrinting。

 

返回
— 具有下列 XML 属性的对象：
  • ignoreComments
  • ignoreProcessingInstructions
  • ignoreWhitespace
  • prettyIndent
  • prettyPrinting

另请参见

示例
下面的示例演示如何在设置 XML 对象之前应用某些自定义设置（以便包含注释和处理指令），如何在设置另一个 XML 对象之前恢复为默认设置，以及如何再次设置自定义设置（以便设置更多 XML 对象）： 
XML.ignoreComments = false;XML.ignoreProcessingInstructions = false;var customSettings:Object = XML.settings();var xml1:XML =
     
      
      
     ;trace(xml1.toXMLString());//    
     
      //        
      //         
      //    
     XML.setSettings(XML.defaultSettings());var xml2:XML =
     
      
      
     ;trace(xml2.toXMLString());
text () 方法  
function text():

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

返回 XML 对象用来表示 XML 文本节点的所有 XML 属性的 XMLList 对象。

 

返回
— 属性列表。

另请参见

toString () 方法  
function toString():

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

返回 XML 对象的字符串表示形式。此转换的规则取决于 XML 对象包含的是简单内容还是复杂内容：

  • 如果 XML 对象包含简单内容，toString() 将返回 XML 对象的字符串内容，但从中除去了以下内容：开始标签、属性、命名空间声明和结束标签。
  • 如果 XML 对象包含复杂内容，toString() 将返回 XML 编码字符串，该字符串表示完整的 XML 对象，包括开始标签、属性、命名空间声明和结束标签。

若要每次都返回整个 XML 对象，请使用 toXMLString()。

 

 

返回
— XML 对象的字符串表示形式。

另请参见

下面的示例演示当 XML 对象包含复杂内容时
toString() 方法的返回值： 
var test:XML =
     
      example
     ;trace(test.toString());// 
     
      // 
      // example//
toXMLString () 方法  
function toXMLString():

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

返回 XML 对象的字符串表示形式。与 toString() 方法不同，toXMLString() 方法始终返回 XML 对象的开始标签、属性和结束标签，与 XML 对象包含的是简单内容还是复杂内容无关。（toString() 方法去除包含简单内容的 XML 对象的这些项。）

 

返回
— XML 对象的字符串表示形式。

另请参见

valueOf () 方法  
function valueOf():

 

语言版本 :  ActionScript 3.0
RuntimeVersions:  AIR 1.0, Flash Player 9

 

 

返回该 XML 对象。

 

返回
— XML 实例的原始值。

另请参见

示例
XMLExample.as
下面的示例先创建一个 XML 变量并向其中添加节点。然后使用 XML 属性查找和输出 XML 节点。请注意，“at”(
@) 符号用在多个
trace() 调用中，以按属性名称查找信息。 
package {import flash.display.Sprite;public class XmlExample extends Sprite {public function XmlExample() {var employees:XML =
     
      
       
       
        
         11 Main St.
        
        
         San Francisco
        
        
         CA
        
        
         98765
        
      
      
       
       
        
         99 Broad St.
        
        
         Newton
        
        
         MA
        
        
         01234
        
      
     ;trace(employees.employee[0].address.zip);   // 98765trace(employees.employee[1].@ssn);          // 789-789-7890trace(employees.employee.name);             // 
     // 
     trace(employees..zip[0]);                   // 98765trace(employees..@ssn[1]);                  // 789-789-7890trace(employees..name);                     // 
     // 
     trace(employees.employee[0].address.*);     // 
     
      11 Main St.
     // 
     
      San Francisco
     // 
     
      CA
     // 
     
      98765
     var node:String = "zip";trace(employees.employee[0].address[node]); // 98765var attribute:String = "ssn";trace(employees.employee[1].@[attribute]);  // 789-789-7890for each (var num:XML in employees..@ssn) {trace(num);                             // 123-123-1234}                                           // 789-789-7890var ssnToFind:String = "789-789-7890";trace(employees.employee.(@ssn == ssnToFind).toXMLString());// 
     
      // 
      // 
      
// 
       
        99 Broad St.
       // 
       
        Newton
       // 
       
        MA
       // 
       
        01234
       // 
// 
     }}}
版权说明

  如果标题未标有<转载、转>等字则属于作者原创，欢迎转载，其版权归作者和博客园共有。

  作      者：温景良
  文章出处：  或 

分类:
+加关注
0
0
上一篇：
下一篇：
posted @ 2009-04-26 22:52 Views(2748) Comments(1)
  
2350605 2012/4/9 13:27:13 2012-04-09 13:27 |
楼主 可否问一下 这个资料在哪个网站。谢谢。。迟到的回复呵呵。。
http://pic.cnblogs.com/face/u282564.jpg?id=14170340
最新IT新闻:
·
·
·
·
·
»
最新知识库文章:
·
·
·
·
·
»

公告

 

 

本文转自博客园博客，原文链接：，如需转载请自行联系原作者

 

 

你可能感兴趣的文章
XML 节点类型
查看>>
驯服 Tiger: 并发集合 超越 Map、Collection、List 和 Set
查看>>
Winform开发框架之权限管理系统改进的经验总结（3）-系统登录黑白名单的实现...
查看>>
Template Method Design Pattern in Java
查看>>
MVC输出字符串常用四个方式
查看>>
LeetCode – LRU Cache (Java)
查看>>
JavaScript高级程序设计--对象，数组（栈方法，队列方法，重排序方法，迭代方法）...
查看>>
【转】 学习ios(必看经典)牛人40天精通iOS开发的学习方法【2015.12.2
查看>>
在 ASP.NET MVC 中使用异步控制器
查看>>
SQL语句的执行过程
查看>>
Silverlight开发历程—动画（线性动画）
查看>>
详解Linux中Load average负载
查看>>
HTTP 协议 Cache-Control 头——性能啊～～～
查看>>
PHP遍历文件夹及子文件夹所有文件
查看>>
WinForm程序中两份mdf文件问题的解决
查看>>
程序计数器、反汇编工具
查看>>
Android N: jack server failed
查看>>
如何将lotus 通讯簿导入到outlook 2003中
查看>>
WinForm 应用程序中开启新的进程及控制
查看>>
js replace，正则截取字符串内容
查看>>
喝酒易醉，品茶养心，人生如梦，品茶悟道，何以解忧？唯有杜康！-- 愿君每日到此一游！
当前时间: 2024-12-26 05:10:32   当前IP: 52.14.223.136   联系邮箱:javaeecc@qq.com     Copyright © 2020 - 2022 baihongyu.com 京ICP备2021015314号-2
强烈建议你试试无所不能的CHAT-GPT，快点击我
强烈建议你试试无所不能的CHAT-GPT，快点击我