Набор данных (TM\_DataSet)

> [HTML Version](tmdataset.html)

Результат выполнения [пользовательских SQL-запросов](workbd.md) будет передан как параметр DataSet во все скрипты с типом события "[Выполнен SQL-запрос](sql-query-completed.md)". Параметр DataSet представляет собой набор данных, полученный в результате выполнения SQL-запроса. Он имеет тип данных TM\_DataSet и включает свойства и методы перечисленные ниже:

Подробные примеры работы с БД можно найти в демо-проекте на странице "Скрипты" -> "Работа с БД", а также в разделе "[Примеры скриптов](https://simple-scada.com/help/script/dbscripts.html)".

| **Метод** | **Описание** |
|------|------|
| First | Перемещает курсор на первую запись набора данных |
| Last | Перемещает курсор на последнюю запись набора данных |
| Next | Перемещает курсор на следующую запись набора данных |
| Prior | Перемещает курсор на предыдущую запись набора данных |
| IsEmpty | Возвращает True, если набор данных пуст |
| MoveBy | Перемещает курсор на указанную дистанцию и возвращает позицию курсора после перемещения |
| FieldByName | Возвращает столбец с заданным именем. Возвращает nil, если столбец не найден |
| BOF | Возвращает True, если курсор в самом начале |
| EOF | Возвращает True, если курсор в самом конце |
| Fields  | Список столбцов набора данных |
| FieldCount | Количество столбцов в наборе данных |
| RecNo | Возвращает порядковый номер текущей записи |
| Sender | Объект, который был передан пользователем при вызове процедуры RunSQL |
| Tag | Целое число, которое было передано пользователем при вызове процедуры RunSQL |