| Пакет | flash.data |
| Класс | public class SQLResult |
| Наследование | SQLResult  Object |
| Язык версии : | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Экземпляр SQLResult для инструкции SQL доступен с помощью метода SQLStatement.getResult() или в качестве аргумента, который передается в результирующий обработчик экземпляра Responder, указанного при вызове метода SQLStatement.execute() или SQLStatement.next(). Как правило, экземпляры SQLResult не создаются непосредственно в прикладном коде.
Объект SQLResult используется для обращения к строкам данных, возвращаемым инструкцией SELECT (с помощью свойства data), получения идентификатора строки для инструкции INSERT (с помощью свойства lastInsertRowID), определения количества строк, обработанных инструкцией INSERT, UPDATE или DELETE (с помощью свойства rowsAffected) или определения наличия дополнительных строк результата выполнения инструкции SELECT, которые не были извлечены (с помощью свойства complete).
См. также
| Свойство | Определено | ||
|---|---|---|---|
 complete : Boolean[только для чтения]
Указывает, все ли данные, полученные в результате выполнения инструкции, были возвращены. | SQLResult | ||
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| data : Array [только для чтения]
Данные, возвращаемые в результате выполнения инструкции, особенно инструкции SQL SELECT. | SQLResult | ||
| lastInsertRowID : Number [только для чтения]
Последний идентификатор строки, созданный инструкцией SQL INSERT. | SQLResult | ||
| prototype : Object [статические]
Ссылка на модель объекта класса или функции. | Object | |
| rowsAffected : Number [только для чтения]
Указывает количество строк, обработанных операцией. | SQLResult | ||
| Метод | Определено | ||
|---|---|---|---|
Создает экземпляр SQLResult. | SQLResult | ||
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
| complete | свойство |
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойстваcomplete:Boolean [только для чтения] | Язык версии : | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Указывает, все ли данные, полученные в результате выполнения инструкции, были возвращены.
Если инструкция возвращает одну или несколько строк, это свойство указывает, все ли строки были возвращены. Если метод execute() объекта SQLStatement был вызван с заданным аргументом prefetch, в свойстве data объекта SQLResult будет возвращено только указанное количество строк полученных данных. Дополнительные данные станут доступны при последующем вызове метода SQLStatement.next(). Это свойство используется, чтобы определить, когда были возвращены конечные данные.
Следует заметить, что из-за того, что во время выполнения количество строк неизвестно, курсор базы данных должен переместиться за последнюю строку до того, как завершится выполнение инструкции. Если при вызове метода SQLStatement.execute() задан аргумент prefetch, необходимо запросить не менее чем на одну запись больше, чем общее количество записей в результирующем наборе, прежде чем свойство complete экземпляра SQLResult получит значение true.
public function get complete():BooleanСм. также
| data | свойство |
data:Array [только для чтения] | Язык версии : | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Данные, возвращаемые в результате выполнения инструкции, особенно инструкции SQL SELECT.
Если инструкция возвращает одну или несколько строк, это свойство содержит массив объектов, у которых имена свойств соответствуют именам столбцов полученного набора данных. Если инструкция не возвращает данные, это свойство равно null.
public function get data():Array| lastInsertRowID | свойство |
lastInsertRowID:Number [только для чтения] | Язык версии : | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Последний идентификатор строки, созданный инструкцией SQL INSERT.
Значение равно 0, если выполненная инструкция не была инструкцией INSERT.
Уникальный идентификатор строки в таблице, используемый для поиска в базе данных. Это значение часто генерируется базой данных.
Дополнительные сведения о первичных ключах и генерируемых идентификаторах строк см. в разделах "CREATE TABLE" и "Выражения" приложения "Поддержка SQL в локальных базах данных".
public function get lastInsertRowID():NumberСм. также
| rowsAffected | свойство |
rowsAffected:Number [только для чтения] | Язык версии : | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Указывает количество строк, обработанных операцией. Учитываются только те изменения, которые были непосредственно указаны в инструкции INSERT, UPDATE или DELETE.
Дополнительные изменения, вызванные триггерами, не учитываются. Свойство SQLConnection.totalChanges используется для нахождения общего числа изменений, включая изменения, вызванные триггерами.
Следует учесть, что если связанной операцией SQL является инструкция DELETE без предложения WHERE (т. е. инструкция удаляет все строки таблицы), свойство rowsAffected всегда будет равно 0, независимо от числа удаленных строк. Чтобы узнать число удаленных строк, можно добавить предложение WHERE в виде WHERE 1 = 1. В этом случае будут удалены все строки, а свойство rowsAffected будет точно отражать их число. Однако, в зависимости от числа удаляемых строк, это может отрицательно сказаться на производительности инструкции.
public function get rowsAffected():NumberСм. также
| SQLResult | () | Конструктор |
public function SQLResult(data:Array = null, rowsAffected:Number = 0, complete:Boolean = true, rowID:Number = 0)| Язык версии : | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Создает экземпляр SQLResult. Как правило, конструктор SQLResult не вызывается непосредственно в прикладном коде. Чтобы извлечь экземпляр SQLResult, связанный с определенным экземпляром SQLStatement, необходимо вызвать метод getResult() этого экземпляра. Экземпляр SQLResult также передается в качестве аргумента в функцию результирующего обработчика, если при вызове метода execute() или next() указан экземпляр Responder.
data:Array (default = null) | |
rowsAffected:Number (default = 0) | |
complete:Boolean (default = true) | |
rowID:Number (default = 0)INSERT, это новый уникальный идентификатор строки.
|