Оснастки расширений типов "массив"

Статья
11/16/2008

Обновлен: Ноябрь 2007

Предоставляют расширение базовых функций типа Array в ECMAScript (JavaScript) за счет добавления статических методов.

Пространство имен: отсутствует. Данное расширение типа является глобальным и не принадлежит к пространству имен.

Наследование от: Array

var arrayVar = new Array("Saturn","Mars","Jupiter");
Array.add(arrayVar, "Earth");

Расширения членов

Имя	Описание
Функция Array.add	Добавляет элемент в конец объекта Array.
Функция Array.addRange	Копирует все элементы указанного массива в конец объекта Array.
Функция Array.clear	Удаляет все элементы из объекта Array.
Функция Array.clone	Создает неполную копию объекта Array.
Функция Array.contains	Определяет, входит ли элемент в состав объекта Array.
Функция Array.dequeue	Удаляет первый элемент из объекта Array.
Функция Array.enqueue	Добавляет элемент в конец объекта Array. Примечание. Используйте функцию add вместо функции Array.enqueue.
Функция Array.forEach	Выполняет заданное действие для каждого элемента объекта Array.
Функция Array.indexOf	Производит поиск указанного элемента объекта Array и возвращает его индекс.
Функция Array.insert	Вставляет значение в указанную позицию объекта Array.
Функция Array.parse	Создает объект Array из строкового представления.
Функция Array.remove	Удаляет первое вхождение элемента из объекта Array.
Функция Array.removeAt	Удаляет элемент из указанного места в объекте Array.

Заметки

Расширения типа Array являются частью библиотеки Microsoft AJAX (библиотека). Они добавляют статические методы к объекту JavaScript Array для обеспечения дополнительных возможностей.

Дополнительные сведения об объекте JavaScript, который расширяется этими статическими методами, и о его конструкторе см. в разделе Объект "Array" в руководстве Справочник по языку.

Пример

В следующем примере показано, как создать новый объект Array и вызвать функцию Microsoft AJAX (библиотека) add для добавления массивов в виде одного элемента массива. Затем многомерный массив передается функции, отображающей массив в документе в виде таблицы.

<!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>

        <div id="results">
        </div>

        <script type="text/javascript">

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

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

            element.innerHTML += tableMarkup;

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

        // Create table data.
        function createTableData() 
        {
               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;
        }  

        var myTable = createTableData();
        var element = $get("results");
        displayTable(myTable, element);

    </script>
    </form>
</body>
</html>

См. также

Ссылки

Объект "Array"

Оператор new

Функции типа "массив"

Поделиться через