TMapSpatialDB.OpenDataSet

 

TMapSpatialDB

Top

 

Открыть набор данных по заданному запросу

 

function OpenDataSet(): integer;

 

Описание:

Открыть набор данных по SQL-запросу. Текст SQL-запроса устанавливается в свойстве SQLText.

Для открытия набора данных необходимо установленное соединение с базой данных.

Кроме непосредственно текста SQL-запроса, должны быть установлены и прочие свойства, определяющие как состав полей самого набора данных, так и свойства, отвечающие за обработку записей набора: должны быть указаны поля метрики, уникального идентификатора, классификационные коды (или поле с их значениями). Если должны быть обработаны семантические характеристики, они также должны быть настроены до вызова данного метода.

После открытия набора данных никакие изменения свойств набора данных не допускаются. Метод OpenDataSet предшествует методу DataSetToMap, запускающему процесс обработки записей набора данных. Между указанными методами допускается только настройка карты-результата.

При успешном выполнении метод OpenDataSet возвращает количество записей в открытом наборе данных. Ноль является допустимым значением (нет записей). При ошибке возвращает -1.