Главная / Action Script 3
(Только AIR)
Пакетflash.data
Классpublic class SQLResult
НаследованиеSQLResult Inheritance Object

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Класс SQLResult обеспечивает доступ к данным, возвращаемым в результате выполнения инструкции SQL (экземпляр SQLStatement).

Экземпляр SQLResult для инструкции SQL доступен с помощью метода SQLStatement.getResult() или в качестве аргумента, который передается в результирующий обработчик экземпляра Responder, указанного при вызове метода SQLStatement.execute() или SQLStatement.next(). Как правило, экземпляры SQLResult не создаются непосредственно в прикладном коде.

Объект SQLResult используется для обращения к строкам данных, возвращаемым инструкцией SELECT (с помощью свойства data), получения идентификатора строки для инструкции INSERT (с помощью свойства lastInsertRowID), определения количества строк, обработанных инструкцией INSERT, UPDATE или DELETE (с помощью свойства rowsAffected) или определения наличия дополнительных строк результата выполнения инструкции SELECT, которые не были извлечены (с помощью свойства complete).

См. также

flash.data.SQLStatement.getResult()
flash.data.SQLStatement.execute()
flash.data.SQLStatement.next()


Общедоступные свойства
 СвойствоОпределено
  AIR-only complete : Boolean
[только для чтения] Указывает, все ли данные, полученные в результате выполнения инструкции, были возвращены.
SQLResult
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  AIR-only data : Array
[только для чтения] Данные, возвращаемые в результате выполнения инструкции, особенно инструкции SQL SELECT.
SQLResult
  AIR-only lastInsertRowID : Number
[только для чтения] Последний идентификатор строки, созданный инструкцией SQL INSERT.
SQLResult
 Inheritedprototype : Object
[статические] Ссылка на модель объекта класса или функции.
Object
  AIR-only rowsAffected : Number
[только для чтения] Указывает количество строк, обработанных операцией.
SQLResult
Общедоступные методы
 МетодОпределено
  
AIR-only SQLResult(data:Array = null, rowsAffected:Number = 0, complete:Boolean = true, rowID:Number = 0)
Создает экземпляр SQLResult.
SQLResult
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
Сведения о свойстве
AIR-only completeсвойство
complete:Boolean  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Указывает, все ли данные, полученные в результате выполнения инструкции, были возвращены.

Если инструкция возвращает одну или несколько строк, это свойство указывает, все ли строки были возвращены. Если метод execute() объекта SQLStatement был вызван с заданным аргументом prefetch, в свойстве data объекта SQLResult будет возвращено только указанное количество строк полученных данных. Дополнительные данные станут доступны при последующем вызове метода SQLStatement.next(). Это свойство используется, чтобы определить, когда были возвращены конечные данные.

Следует заметить, что из-за того, что во время выполнения количество строк неизвестно, курсор базы данных должен переместиться за последнюю строку до того, как завершится выполнение инструкции. Если при вызове метода SQLStatement.execute() задан аргумент prefetch, необходимо запросить не менее чем на одну запись больше, чем общее количество записей в результирующем наборе, прежде чем свойство complete экземпляра SQLResult получит значение true.



Реализация
    public function get complete():Boolean

См. также

AIR-only dataсвойство 
data:Array  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Данные, возвращаемые в результате выполнения инструкции, особенно инструкции SQL SELECT.

Если инструкция возвращает одну или несколько строк, это свойство содержит массив объектов, у которых имена свойств соответствуют именам столбцов полученного набора данных. Если инструкция не возвращает данные, это свойство равно null.



Реализация
    public function get data():Array
AIR-only lastInsertRowIDсвойство 
lastInsertRowID:Number  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Последний идентификатор строки, созданный инструкцией SQL INSERT.

Значение равно 0, если выполненная инструкция не была инструкцией INSERT.

Уникальный идентификатор строки в таблице, используемый для поиска в базе данных. Это значение часто генерируется базой данных.

Дополнительные сведения о первичных ключах и генерируемых идентификаторах строк см. в разделах "CREATE TABLE" и "Выражения" приложения "Поддержка SQL в локальных базах данных".



Реализация
    public function get lastInsertRowID():Number

См. также

AIR-only rowsAffectedсвойство 
rowsAffected:Number  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Указывает количество строк, обработанных операцией. Учитываются только те изменения, которые были непосредственно указаны в инструкции INSERT, UPDATE или DELETE.

Дополнительные изменения, вызванные триггерами, не учитываются. Свойство SQLConnection.totalChanges используется для нахождения общего числа изменений, включая изменения, вызванные триггерами.

Следует учесть, что если связанной операцией SQL является инструкция DELETE без предложения WHERE (т. е. инструкция удаляет все строки таблицы), свойство rowsAffected всегда будет равно 0, независимо от числа удаленных строк. Чтобы узнать число удаленных строк, можно добавить предложение WHERE в виде WHERE 1 = 1. В этом случае будут удалены все строки, а свойство rowsAffected будет точно отражать их число. Однако, в зависимости от числа удаляемых строк, это может отрицательно сказаться на производительности инструкции.



Реализация
    public function get rowsAffected():Number

См. также

Сведения о конструкторе
AIR-only SQLResult()Конструктор
public function SQLResult(data:Array = null, rowsAffected:Number = 0, complete:Boolean = true, rowID:Number = 0)

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Создает экземпляр SQLResult. Как правило, конструктор SQLResult не вызывается непосредственно в прикладном коде. Чтобы извлечь экземпляр SQLResult, связанный с определенным экземпляром SQLStatement, необходимо вызвать метод getResult() этого экземпляра. Экземпляр SQLResult также передается в качестве аргумента в функцию результирующего обработчика, если при вызове метода execute() или next() указан экземпляр Responder.

Параметры
data:Array (default = null) — Массив строк, возвращенный в результате выполнения инструкции. Если инструкция не возвращает ни одной строки, это значение должно быть равно null.
 
rowsAffected:Number (default = 0) — Указывает количество строк, обработанных выполненной инструкцией.
 
complete:Boolean (default = true) — Указывает, имеются ли дополнительные строки для выборки или все данные были возвращены.
 
rowID:Number (default = 0) — Если инструкция является операцией SQL INSERT, это новый уникальный идентификатор строки.