ASP.NET AJAX 说明文档->客户端引用->全局命名空间->JavaScript 基础类型扩展->Array 类型扩展

Array 类型扩展

提供了基于ECMAScript (JavaScript) 的 Array 对象的扩展.

命名空间: 无.本扩展类型是全局型的不属于任意一命名空间.

继承: Array

语法

var  arrayVar  =   new  Array();

成员扩展

名称	说明
Array.add函数	在Array对象结尾追加指定的元素.
Array.addRange函数	将另一个 Array对象 的元素添加到 Array对象 的末尾
Array.clear函数	从 Array对象 中移除所有元素。
Array.clone函数	创建 Array 的浅表副本
Array.contains函数	确定某元素是否在 Array 中。
Array.dequeue函数	从 Array对象 中移除第一个元素。(原书写有误)
Array.enqueue函数	在 Array对象 结尾追加指定的元素. 注意 请使用add函数 代替 Array.enqueue函数.
Array.forEach函数	对指定数组的每个元素执行指定操作。
Array.indexOf函数	返回 Array 中某个值第一个匹配项的索引。
Array.insert函数	在 Array 对象中的指定位置插入一个值.
Array.parse函数	将一个字符串表示的数组转化为Array对象.
Array.remove函数	从 Array 中移除特定对象的第一个匹配项。
Array.removeAt函数	移除 Array 的指定索引处的元素。

备注

Array 扩展是 Microsoft AJAX 库的一部分. JavaScript Array 对象的 add函数以及它所提供的其它成员与.NET程序结合的更加密切。

更多关于 JavaScript 类的扩展类型的消息，请参见Array 类 in the JScript Language Reference.

下面的示例展示了如何创建一个 Array 对象 并使用 Microsoft AJAX 类库的add函数 将几个Array添加至一个Array. 并展示如何显示运行结果。

CS

<% @ Page Language = " C# "   %>
<! DOCTYPE html PUBLIC  " -//W3C//DTD XHTML 1.0 Transitional//EN "   " http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd " >


< html xmlns = " http://www.w3.org/1999/xhtml "   >
< head runat = " server " >
     < title > Sample </ title >
</ head >
< body >
     < form id = " form1 "  runat = " server " >
                < asp:ScriptManager runat = " server "  ID = " ScriptManager1 " >
                </ asp:ScriptManager >
     </ form >
</ body >
</ html >

< script type = " text/javascript " >

    Type.registerNamespace( ' Samples ' );

    Samples.ArrayExample  = function(){}
    Samples.ArrayExample.prototype  =  {

         //  Create and display a table based on array content.
        displayTable:function(arrayTable) 
        {
            document.write( " <table border=on> " );
            var rows  =  arrayTable[ 0 ][ 0 ].length;

             for (x = 0 ; x <= rows; x ++ )
            {
               document.write( " <tr> " );
               var columns  =  arrayTable[x].length  -   1 ;
                for (y = 0 ; y <= columns; y ++ )
               {
                    document.write( " <td> " , arrayTable[x][y],  " </td> " );
               }
               document.write( " /<tr> " );
            }
            document.write( " </table> " );

             //  Clean up.
            Array.clear(arrayTable);
        },

         //  Create table data.
        createTableData:function() 
        {
               var costsArray  =  [];

               var headerRow  =   new  Array( " ID " ,  " Name " ,  " Costs " );
               var firstRow  =   new  Array( " 1 " ,  " ruler " ,  " 1.30 " );
               var secondRow  =   new  Array( " 2 " ,  " binder " ,  " 4.75 " );

               Array.add(costsArray, headerRow);
               Array.add(costsArray, firstRow);
               Array.add(costsArray, secondRow);

                return  costsArray;
        }  
    }

    Samples.ArrayExample.registerClass( ' Samples.ArrayExample ' );

    var myArraySample  =   new  Samples.ArrayExample();
    var myTable  =  myArraySample.createTableData();
    myArraySample.displayTable(myTable);

</ script >

VB

< %@ Page Language = " VB "  % >
< !DOCTYPE html  PUBLIC   " -//W3C//DTD XHTML 1.0 Transitional//EN "   " http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd " >


< html xmlns = " http://www.w3.org/1999/xhtml "   >
< head id = " Head1 "  runat = " server " >
     < title > Sample </ title >
</ head >
< body >
     < form id = " form1 "  runat = " server " >
                < asp:ScriptManager runat = " server "  ID = " ScriptManager1 " >
                </ asp:ScriptManager >
     </ form >
</ body >
</ html >

< script type = " text/javascript " >

    Type.registerNamespace( ' Samples');

    Samples.ArrayExample  = function (){}
    Samples.ArrayExample.prototype  =  {

         //  Create  and  display a table based  on   array  content.
        displayTable: function (arrayTable) 
        {
            document.write( " <table border=on> " );
            var rows  =  arrayTable[ 0 ][ 0 ].length;

             for (x = 0 ; x <= rows; x ++ )
            {
               document.write( " <tr> " );
               var columns  =  arrayTable[x].length  -   1 ;
                for (y = 0 ; y <= columns; y ++ )
               {
                    document.write( " <td> " , arrayTable[x][y],  " </td> " );
               }
               document.write( " /<tr> " );
            }
            document.write( " </table> " );

             //  Clean up.
             Array .clear(arrayTable);
        },

         //  Create table data.
        createTableData: function () 
        {
               var costsArray  =  [];

               var headerRow  =   new   Array ( " ID " ,  " Name " ,  " Costs " );
               var firstRow  =   new   Array ( " 1 " ,  " ruler " ,  " 1.30 " );
               var secondRow  =   new   Array ( " 2 " ,  " binder " ,  " 4.75 " );

                Array .add(costsArray, headerRow);
                Array .add(costsArray, firstRow);
                Array .add(costsArray, secondRow);

               return costsArray;
        }  
    }

    Samples.ArrayExample.registerClass( ' Samples.ArrayExample');

    var myArraySample  =   new  Samples.ArrayExample();
    var myTable  =  myArraySample.createTableData();
    myArraySample.displayTable(myTable);

</ script >

请参见

• Array 类
• new Operator

  链接有很多都不正确，翻译后，会慢慢进行补充，英语不好如果有译的不对的地方希望大家 一定要及时指出，谢谢大家关注
--邹健