13.3. Описание API SQL

13.3.3.1.1. Параметры

13.3.3.1.2. Возвращаемое значение

Количество затронутых записей.

13.3.3.1.3. Описание

Command() используется для выполнения операторов SQL,кроме запросов SELECT (в т.ч. операторов, возвращающих результирующие строки). Для выполнения запроса, возвращающего строки, используйте TConnect:CreateRowset() даже если вы не заинтересованы в получении результатов.

Оператор SQL может получать параметры. Имени параметра в <cSQL> должен предшествовать символ ':'. Значения параметров передаются в двухмерном массиве <aParameters>.

Если нет активной транзакции, изменения, сделанные оператором <cSQL> коммитятся (вступают в силу) сразу. Если нужно другое поведение вызывайте TConnect:Start() явно.

Возвращаемое значение - количество затронутых записей, например количество удаленных записей в случае оператора DELETE.

13.3.3.1.4. Пример

conn:Command("CREATE TABLE mytable (fname char(20),lname char(20))")
conn:Command("INSERT INTO mytable VALUES (:firstname,:lastname)",;
	{{"firstname","John"},{"lastname","Smith"}})
? conn:Command("DELETE FROM mytable WHERE fname=:fname",;
	{{"fname","John"}}) // 1

13.3.3.2.1. Описание

Commit() подтверждает все изменения, сделанные в транзакции, запущенной функцией TConnect:Start(),и завершает транзакцию. Если нет активных транзакций, генерируется ошибка.

13.3.3.2.2. Пример

conn:Start()
// ...
// some changes
// ...
conn:Commit()

13.3.3.3.1. Описание

Когда приложению больше не требуется доступ к SQLсерверу, следует отсоединитьсяот него и освободить занимавшиеся системные ресурсы при помощи вызова деструктора Destroy().

13.3.3.3.2. Пример

conn := ConnectNew("PG",,,,,"template1")
// ...
// do some work
// ...
conn:Destroy()

13.3.3.4.1. Параметры

13.3.3.4.2. Возвращаемое значение

Объект TRowset.

13.3.3.4.3. Описание

CreateRowset() выполняет запрос SELECT, строит локальный набор результирующих записей и возвращает объект TRowset. То есть эту функцию можно рассматривать как конструктор класса TRowset. 'Запрос SELECT' означает любой оператор SQL, возвращающий результирующие записи (или пустой набор записей). Использование оператора SQL любого другого вида приведет к ошибке.

<cInsertSQL>, <cDeleteSQL>, <cUpdateSQL> - дополнительные параметры, предназначенные для облегчения модификации таблиц базы данных. Если не переданы, соответствующие изменения набора записей не отражаются в базе данных. <cInsertSQL> выполняется автоматически методом TRowset:Append(). Таким же образом, <cDeleteSQL> выполняется методом TRowset:Delete(), а <cUpdateSQL> - методом TRowset:Write().

<cRefreshSQL> выполняется автоматически методом TRowset:RefreshCurrent(). <cRefreshSQL> должен запрашивать точно такой же список полей, что и <cSelectSQL>.

Редактируемый набор записей должен содержать поле - идентификатор записи с уникальными значениями, используемый для связывания записей таблицы базы данных и строк набора. Необходимо явно включать это поле в список запрашиваемых полей запроса SELECT. Для различных СУБД существуют различные подходы к реализации механизма связывания записей таблицы и строк набора.

• Некоторые СУБД имеют 'скрытые' поля - идентификаторы записей для каждой хранимой таблицы (ROWID в Oracle, OID в PostgreSQL). Эти поля создаются неявно, даже если вы не включали его описания в список полей оператора CREATE TABLE. PostgreSQL понимает такой синтаксис:

  SELECT oid,* FROM mytable

  В отличие от PostgreSQL, Oracle не понимает такого синтаксиса. Необходимо перечислить все запрашиваемые поля:

  SELECT rowid,fname,lname FROM mytable

• Некоторые СУБД предоставляют возможность использования автоинкрементных полей с уникальными значениями. Синтаксис оператора CREATE TABLE вMySQL позволяет использовать предложение AUTO_INCREMENT в определении поля. CLIP распознает такие поля и использует их в качестве идентификаторов записей. Никаких других действий кроме включения поля AUTO_INCREMENT в таблицу, которую предполагается редактировать при помощи методов класса TRowset, не требуется.

• Некоторые СУБД (Interbase) предоставляют механизм триггеров и генераторы уникальных значений. Типичный подход в этом случае - создать триггер BEFORE INSERT, который получает уникальное значение от генератора и присваивает его полю - идентификатору записи. Но не существует способа определить значение поля - идентификатора записи вновь вставленной записи. То есть невозможно изменить или удалить (при помощи операторов UPDATE и DELETE) вновь вставленную запись (добавленную после того как был создан объект TRowset). Есть два выбора:

  1. оформлять приложение с учетом этого ограничения (никогда не изменять вновь вставленные записи);

  2. не использовать триггер BEFORE INSERT, а передавать конструктору TRowset параметр <cGenIdSQL> с запросом к генератору уникальных значений. Этот оператор должен возвращать новое уникальное значение, которое будет затем присвоено полю с именем <cIdName> во время выполнения оператора <cInsertSQL>.

  Атрибут таблиц Interbase под названием RDB$DB_KEY в действительности не является идентификатором записи, а скорее адресом записи, которое может меняться (как RECNO(), значение которого может измениться после PACK). Поэтому этот атрибут не используется в качестве идентификатора записей.

• В случае использования СУБД не предоставляющих никаких из вышеперечисленных возможностей (ODBC,DBTCP), необходимо передавать параметр <cIdName> с именем поля - идентификатора записи и оформлять ваши приложения таким образом, чтобы никогда не изменялись вновь вставленные записи.

Операторы SQL <cInsertSQL>, <cDeleteSQL>, <cUpdateSQL> и <cRefreshSQL> получают значения полей через параметры SQL с именами совпадающими с именами полей набора. Например:

<cSelectSQL>  - SELECT DriverID AS id,fname,lname FROM mytable
<cInsertSQL>  - INSERT INTO mytable (fname,lname) VALUES (:fname,:lname)
<cUpdateSQL>  - UPDATE mytable SET fname=:fname,lname=:lname WHERE DriverId=:id
<cDeleteSQL>  - DELETE FROM mytable WHERE DriverId=:id
<cRefreshSQL> - SELECT DriverID,fname,lname FROM mytable WHERE DriverId=:id

Имеется три макроса: %FIELDS, %VALUES для использования в операторе INSERT; %LIST для использования в операторе UPDATE. %FIELDS преобразуется в список имен полей; %VALUES - в список параметров; %LIST - в список полей и параметров. Например:

INSERT INTO mytable (%FIELDS) VALUES (%VALUES)
UPDATE mytable SET %LIST

Имеется два режима загрузки записей, управляемые параметром <lNoFetch>: полная загрузка и загрузка по требованию.

• В первом режиме (<lNoFetch>==.F.) все результирующие записи загружаются до завершения CreateRowset(). В этом режиме можно сразу использовать TRowset:Lastrec() для определения количества результирующих записей. Можно использовать <bEval> для наблюдения и прерывания процесса загрузки.

• Во втором режиме (<lNoFetch>==.T.) записи загружаются по требованию (в процессе навигации по набору). Этот режим гораздо быстрее, но Lastrec() возвращает рельное количество результирующих записей только после того как загрузятся все записи. В этом режиме параметр <bEval> игнорируется.

Когда приложению больше не требуется набор строк, оно должно освободить занимаемые ресурсы при помощи вызова метода-деструктора TRowset:Destroy().

13.3.3.4.4. Примеры

• Простой пример, в котором создается нередактируемый набор записей:

  rs := conn:CreateRowset("SELECT * FROM mytable WHERE fname = 'John'")
  rs:Browse()

• Создание набора записей с использованием параметров SQL:

  rs := conn:CreateRowset("SELECT * FROM mytable WHERE fname = :par1",;
  	{{"par1","John"}})
  rs:Browse()

• Создание редактируемого набора записей:

  rs := conn:CreateRowset("SELECT id,fname,lname FROM mytable",NIL,;
  	"INSERT INTO mytable (%FIELDS) VALUES (%VALUES)",;
  	"DELETE FROM mytable WHERE id=:id",;
  	"UPDATE mytable SET fname=:fname,lname=:lname",;
  	"SELECT id,fname,lname FROM mytable WHERE id=:id",;
  	"id")

• Создание набора записей с локальными индексами 'id' и 'fullname':

  rs := conn:CreateRowset("SELECT id,fname,lname FROM mytable",,,,,,,;
  	{{"id","id"},;
  	{"fullname",{|rs| rs:GetValue("fname")+rs:GetValue("lname")},40}})
  rs:Browse()                 // show rows in natural order
  rs:SetOrder("id")
  rs:Browse()                 // show rows ordered by id
  rs:SetOrder("fullname")
  rs:Browse()                 // show rows ordered by fname and lname

• Использование <bEval> для наблюдения за процессом загрузки (через каждые 100 загруженные записи печатается точка), который можно прервать нажатием ESC:

  rs := conn:CreateRowset("SELECT * FROM hugetable",,,,,,,,,,;
  	{|| qqout("."),inkey() != K_ESC}, 100)
  rs:browse()

• Загрузка записей по требованию:

  rs := conn:CreateRowset("SELECT * FROM hugetable",,,,,,,,,.T.)
  rs:Gotop()
  ? rs:Fetched() // 1
  ? rs:Lastrec() // 0
  for i:=1 to 100
  	rs:Skip()
  	? rs:Fetched() // 2,3,...,101
  next
  rs:FetchAll()
  ? rs:Lastrec() == rs:Fetched() // .T.

13.3.3.5.1. Описание

Rollback() отменяет все изменения сделанные во время транзакции и завершает транзакцию. Если нет активной транзакции генерируется ошибка.

13.3.3.5.2. Пример

conn:Start()
// ...
// some changes
// ...
conn:Rollback()

13.3.3.6.1. Параметры

13.3.3.6.2. Описание

Start() стартует новую транзакцию. В момент запуска новой транзакция предыдущая должна быть завершена, иначе генерируется ошибка. Транзакция должна быть когда-нибудь завершена при помощи TConnect:Commit() или TConnect:Rollback().

Если нет активной транзакции, все изменения таблицы вступают в силу после каждого выполненного оператора SQL.

13.3.3.6.3. Пример

conn:Start()
// ...
// some changes
// ...
conn:Commit() // commit changes

13.3.4.1.1. Параметры

13.3.4.1.2. Описание

Append() добавляет новую строку к набору и присваивает значения атрибутов <oRow> соответствующим полям новой записи.

Если конструктору набора записей был передан параметр <cInsertSQL>, то последний исполняется на SQL сервере со значениями полей новой записи.

Если набор был создан в режиме 'загрузка по требованию' (<lNoFetch>==.T.), то предварительно дозагружаются все оставшиеся записи.

Append() увеличивает количество строк в наборе, возвращаемое методом TRowset:Lastrec().

Указатель перемещается на новую строку.

13.3.4.1.3. Пример

rs := conn:CreateRowset("SELECT id,fname,lname FROM mytable",,;
	"INSERT INTO mytable (fname,lname) VALUES (:fname,:lname)")
obj := map()          // create an empty object
obj:fname := "John"   // set attributes with the same names as fields
obj:lname := "Smith"  // ...
// add new row and execute
// INSERT INTO mytable (fname,lname) VALUES ('John','Smith')
rs:Append(obj)

13.3.4.2.1. Возвращаемое значение

.T. после попытки переместиться в обратном направлении за первую логическую строку набора; в противном случае возвращается .F. Если набор не содержит ни одной строки возвращается .T.

13.3.4.2.2. Описание

Bof() используется для проверки условия достижения границ набора при перемещении указателя в обратном направлении при помощи метода TRowset:Skip().

После того, как функцией Bof() будет установлено значение .T., оно остается до тех пор, пока не будет сделана очередная попытка передвижения указателя записи.

TRowset:Skip() является единственной функцией, которая может установить значение Bof() == .T.

13.3.4.2.3. Пример

rs := conn:CreateRowset("SELECT * FROM mytable")
? rs:Recno() // 1
? rs:Bof()   // .F.
rs:Skip(-1)
? rs:Recno() // 1
? rs:Bof()   // .T.

13.3.4.3.1. Параметры

13.3.4.3.2. Описание

Browse() - функция пользовательского интерфейса предоставляющая простой просмотр строк набора.

13.3.4.3.3. Пример

rs := conn:CreateRowset("SELECT id,fname,lname FROM mytable",,,,,,,,,.T.)
rs:Browse(,,,,{"fname","lname"},{"First name","Last name"},{20,20})

13.3.4.4.1. Параметры

13.3.4.4.2. Описание

CreateOrder() используется для создания локального индекса, то есть индекса в памяти, управляющего логическим порядком строк в наборе. Созданный индекс может затем быть установлен управляющим при помощи метода TRowset:SetOrder(). Кроме того, управляющий индекс может использоваться для быстрого поиска строки, содержащей заданный ключ при помощи метода TRowset:Seek() function.

Если набор был создан в режиме 'загрузка по требованию' (<lNoFetch>==.T.), то предварительно дозагружаются все оставшиеся записи.

13.3.4.4.3. Пример

В этом примере создаются два индекса ('birthdate' и 'fullname'); показываются записи отсортированные в порядке даты рождения и полного имени; ищется работник, чье имя начинается с 'Joh':

rs := conn:CreateRowset("SELECT bdate,fname,lname FROM employee")
rs:CreateOrder("birthdate","bdate")
rs:CreateOrder("fullname",{|rs| rs:GetValue("fname")+rs:GetValue("lname")},40)
rs:SetOrder("birthdate")
rs:Browse()
rs:SetOrder("fullname")
rs:Browse()
? rs:Seek("Joh") // .T.
row := rs:Read()
? row:fname       // John

13.3.4.5.1. Описание

Delete() удаляет текущую строку из набора.

Если конструктору набора был передан параметр <cDeleteSQL>, последний выполняется на SQL сервере со значением поля - идентификатора текущей записи.

Если набор был создан в режиме 'загрузка по требованию' (<lNoFetch>==.T.), то предварительно дозагружаются все оставшиеся записи.

Delete() уменьшает количество строк в наборе, возвращаемое методом TRowset:Lastrec().

Если нет управляющего индекса позиция указателя текущей строки не изменяется, или перемещается к последней строке (когда удаляется последняя физическая строка (Recno()==Lastrec()).

Если есть управляющий индекс (установленный методом TRowset:SetOrder()) указатель текущей строки перемещается к следующей логической строке, или перемещается к последней логической строке (когда удаляется строка с наибольшим значением ключа).

Если удаляется последняя оставшаяся строка, состояния Bof() и Eof() устанавливаются в .T. и TRowset:Recno() возвращает 0.

13.3.4.5.2. Пример

rs := conn:CreateRowset("SELECT id,fname,lname FROM mytable",,,;
	"DELETE FROM mytable WHERE id=:id")
? rs:Lastrec() // 10
// delete a row and execute
// DELETE FROM mytable WHERE id=...
rs:Delete()
? rs:Lastrec() // 9

13.3.4.6.1. Описание

Когда приложению больше не требуется набор строк, оно должно освободить занимаемые ресурсы при помощи вызова метода-деструктора TRowset:Destroy().

13.3.4.6.2. Пример

rs := conn:CreateRowset("SELECT * FROM mytable")
// ...
// do some work
// ...
rs:Destroy()

13.3.4.7.1. Возвращаемое значение

.T. после попытки переместиться в прямом направлении за последнюю логическую строку набора; в противном случае возвращается .F. Если набор не содержит ни одной строки возвращается .T.

13.3.4.7.2. Описание

Eof() используется для проверки условия достижения границ набора при перемещении указателя в прямом направлении при помощи метода TRowset:Skip().

После того, как функцией Eof() будет установлено значение .T., оно остается до тех пор, пока не будет сделана очередная попытка передвижения указателя записи.

TRowset:Skip() является единственной функцией, которая может установить значение Eof() == .T.

В отличие от команды SKIP, использеумой в XBase, TRowset:Skip() никогда не перемещает указатель за последнюю логическую строку. Когда TRowset:Eof() возвращает .T. указатель находится на последней логической строке, а не на Lastrec()+1.

13.3.4.7.3. Пример

rs := conn:CreateRowset("SELECT * FROM mytable")
rs:GoBottom()
? rs:Recno() // 100
? rs:Eof()   // .F.
rs:Skip()
? rs:Recno() // 100
? rs:Eof()   // .T.
rs:Skip(-1)
? rs:Recno() // 99
? rs:Eof()   // .F.

13.3.4.8.1. Возвращаемое значение

Количество строк в наборе.

13.3.4.8.2. Описание

FetchAll() дозагружает оставшиеся записи в набор. Это бывает необходимо, когда набор был создан в режиме 'загрузка по требованию'. Если все записи уже загружены, FetchAll() ничего не делает.

13.3.4.8.3. Пример

rs := conn:CreateRowset("SELECT * FROM mytable",,,,,,,,,.T.)
? rs:Lastrec()  // 0
? rs:Fetched()  // 1
? rs:FetchAll() // number of selected rows
? rs:Lastrec()  //         - " -
? rs:Fetched()  //         - " -

13.3.4.9.1. Возвращаемое значение

Количество загруженных строк.

13.3.4.9.2. Описание

Fetched() используется для определения количества загруженных строк. Это бывает необходимо в блоке кода <bEval>, передаваемом конструктору набора TConnect:CreateRowset(), и при создании набора в режиме 'загрузка по требованию'.

13.3.4.9.3. Примеры

• Выводится количество загруженных строк в процессе загрузки:

  rs := conn:CreateRowset("SELECT * FROM hugetable",,,,,,,,,,;
  	{|rs| qout(rs:Fetched())},100)

• Использование Fetched() с набором, созданным в режиме 'загрузка по требованию':

  rs := conn:CreateRowset("SELECT * FROM hugetable",,,,,,,,,.T.)
  ? rs:Fetched() // 1
  rs:Skip()
  ? rs:Fetched() // 2
  rs:Skip(100)
  ? rs:Fetched() // 102

13.3.4.10.1. Параметры

13.3.4.10.2. Возвращаемое значение

.T. если поле бинарное, .F. в противном случае.

13.3.4.10.3. Описание

FieldBinary() используется для определения, является ли поле бинарным. Бинарные поля не подвергаются перекодировкам.

13.3.4.10.4. Пример

? rs:FieldBinary("fname") // .F.

13.3.4.11.1. Параметры

13.3.4.11.2. Возвращаемое значение

Блок кода, устанавливающий или получающий значение поля.

13.3.4.11.3. Описание

FieldBlock() строит блок кода для доступа к заданному полю. Если блоку передается параметр, значение поля устанавливается значением этого параметра. Если блоку не передается параметров, то он возвращает значение поля.

Изменение набора с использованием этого блока кода не вызывает незамедлительного выполнения <cUpdateSQL> (параметра конструктора набора TConnect:CreateRowset()). Выполнение <cUpdateSQL> на сервере инициируется лишь методом Write(), а также всеми методами, перемещающими указатель (Gotop()Gobottom()Goto() и Skip()).

13.3.4.11.4. Пример

cb := rs:FieldBlock("fname")
? eval(cb)   // 'John'
eval(cb,'Richard')
? eval(cb)   // 'Richard'
rs:Write(rs:Read()) // cause UPDATE-ing on the server

13.3.4.12.1. Параметры

13.3.4.12.2. Возвращаемое значение

Количество знаков после запятой для заданного поля.

13.3.4.12.3. Описание

FieldDec() используется для определения количества десятичных знаков после запятой, используемых в заданном поле.

13.3.4.12.4. Пример

? rs:FieldDec("salary")

13.3.4.13.1. Параметры

13.3.4.13.2. Возвращаемое значение

Длина поля (в терминах используемой СУБД).

13.3.4.13.3. Описание

FieldLen() используется для определения длины заданного поля, в терминах используемой СУБД. Например, длина поля типа 'FLOAT' равна 4.

13.3.4.13.4. Пример

? rs:FieldLen("salary")

13.3.4.14.1. Параметры

13.3.4.14.2. Возвращаемое значение

Имя поля.

13.3.4.14.3. Описание

FieldName() используется для определения имени поля с заданной позицией.

13.3.4.14.4. Пример

? rs:FieldName(1) // fname

13.3.4.15.1. Параметры

13.3.4.15.2. Возвращаемое значение

Позиция поля.

13.3.4.15.3. Описание

FieldNo() используется для определения позиции поля с заданным именем.

13.3.4.15.4. Пример

? rs:FieldName('fname') // 1

13.3.4.16.1. Параметры

13.3.4.16.2. Возвращаемое значение

.T. если поле может принимать значения NULL; .F. - в противном случае (поле NOT NULL).

13.3.4.16.3. Описание

FieldNullable() используется для определения, может ли поле принимать значения NULL.

13.3.4.16.4. Пример

? rs:FieldNullable("fname") // .T.

13.3.4.17.1. Параметры

13.3.4.17.2. Возвращаемое значение

Код, определяющий тип поля (XBase).

13.3.4.17.3. Описание

FieldType() используется для определения типа поля. Функция возвращает один символ, определяющий тип данных. Возвращается один из следующих символов:

• C - строка символов

• N - число

• D - дата

• T - дата и время

• L - логическое значение

13.3.4.17.4. Пример

? rs:FieldType("salary") // 'N'

13.3.4.18.1. Параметры

13.3.4.18.2. Возвращаемое значение

Код, определяющий тип поля (в терминах используемой СУБД).

13.3.4.18.3. Описание

FieldTypeSQL используется для определения типа поля, в терминах используемой СУБД. Типы данных конкретных СУБД определены в соответствующих заголовочных *.ch файлах, включенных в состав пакетов.

13.3.4.18.4. Пример

? rs:FieldTypeSQL("salary")

13.3.4.19.1. Параметры

13.3.4.19.2. Возвращаемое значение

.T. если поле беззнаковое; .F. - в противном случае.

13.3.4.19.3. Описание

FieldUnsigned() используется для определения, является ли поле беззнаковым.

13.3.4.19.4. Пример

? rs:FieldUnsigned("salary") // .T.

13.3.4.20.1. Параметры

13.3.4.20.2. Возвращаемое значение

Значение поля текущей строки.

13.3.4.20.3. Описание

GetValue() используется для определения значения заданного поля текущей строки.

13.3.4.20.4. Пример

? rs:GetValue('fname') // John

13.3.4.21.1. Описание

GoBottom() перемещает указатель к последней логической строке.

Если набор был создан в режиме 'загрузка по требованию' (<lNoFetch>==.T.), то предварительно дозагружаются все оставшиеся записи.

13.3.4.21.2. Пример

rs:CreateRowset("SELECT * FROM mytable",,,,,,,,,.T.)
? rs:Recno()   // 1
? rs:Lastrec() // 0 (there remain unfetched rows)
rs:GoBottom()
? rs:Recno()   // number of selected rows
? rs:Lastrec() // number of selected rows (no unfetched rows remain)

13.3.4.22.1. Параметры

13.3.4.22.2. Возвращаемое значение

Новый номер текущей строки.

13.3.4.22.3. Описание

Goto() используется для перемещения к строке с заданным номером.

Если <nRowPosition> меньше 1, Goto() перемещает указатель к строке с номером 1 и состояние Bof() устанавливается в .T. Если <nRowPosition> больше, чем Lastrec(), Goto() перемещает указатель к последней физической строке, и состояние Eof() устанавливается в .T.

13.3.4.22.4. Пример

for i:=1 to rs:Lastrec()
	rs:goto(i)
	? rs:Read()
next

13.3.4.23.1. Описание

GoTop() перемещает указатель к первой логической строке.

13.3.4.23.2. Пример

rs:CreateRowset("SELECT fname,lname FROM mytable")
? rs:Recno()   // 1
rs:CreateOrder("fname","fname",20)
rs:SetOrder("fname")
rs:GoTop()
? rs:Recno()   // the position of first logical row

13.3.4.24.1. Возвращаемое значение

Логический номер текущей строки.

13.3.4.24.2. Описание

KeyNo() используется для определения логического номера текущей строки. Если нет управляющего индекса (созданного методом TRowset:CreateOrder() и установленного управляемым методом TRowset:SetOrder()), KeyNo() возвращает физический номер строки, то есть имеет тот же эффект, что и метод TRowset:Recno().

13.3.4.24.3. Пример

rs := conn:CreateRowset("SELECT fname,lname FROM mytable")
rs:CreateOrder("fname","fname",20)
? rs:KeyNo(), rs:Recno() // 1, 1 (no controlling order)
rs:SetOrder("fname")     // set controlling order by fname
? rs:KeyNo(), rs:Recno() // N, 1
rs:GoTop()
? rs:KeyNo(), rs:Recno() // 1, M

13.3.4.25.1. Возвращаемое значение

Количество строк в наборе.

13.3.4.25.2. Описание

Lastrec() возвращает количество строк в наборе.

Если набор был создан в режиме 'загрузка по требованию' (параметр <lNoFetch> конструктора TConnect:CreateRowset() - .T.), Lastrec() может возвращать 0 (когда загружены не все записи). Количество загруженных строк можно определить с помощью метода TRowset:Fetched(). Для дозагрузки оставшихся записей можно использовать метод TRowset:FetchAll(). После этого Lastrec(), будет возвращать действительноеколичество строк в наборе.

13.3.4.25.3. Пример

rs := conn:CreateRowset("SELECT * FROM mytable",,,,,,,,,.T.)
? rs:Lastrec() // 0
rs:FetchAll()
? rs:Lastrec() // number of selected rows

13.3.4.26.1. Возвращаемое значение

Количество полей в наборе.

13.3.4.26.2. Описание

NFields() используется для определения количества полей в строках набора.

13.3.4.26.3. Пример

rs := conn:CreateRowset("SELECT fname,lname FROM mytable")
? rs:NFields() // 2

13.3.4.27.1. Возвращаемое значение

Объект, содержащий все поля текущей строки.

13.3.4.27.2. Описание

Read() получает значения всех полей текущей строки и помещает их в одноименные атрибуты возвращаемого объекта.

13.3.4.27.3. Пример

rs := conn:CreateRowset("SELECT fname,lname FROM mytable")
? rs:Read():fname // John
? rs:Read():lname // Smith

13.3.4.28.1. Возвращаемое значение

Физический номер текущей строки.

13.3.4.28.2. Описание

Recno() используется для определения физического номера текущей строки. Если в наборе не ни одной строки, возвращается 0.

13.3.4.28.3. Пример

rs := conn:CreateRowset("SELECT * FROM mytable")
? rs:Recno() // 1
rs:Skip()
? rs:Recno() // 2
rs:Goto(100)
? rs:Recno() // 100

13.3.4.29.1. Возвращаемое значение

Количество строк в наборе.

13.3.4.29.2. Описание

RefreshAll() обновляет набор строк путем повторного выполнения <cSelectSQL>, переданного конструктору класса TRowset (TConnect:CreateRowset()), с использованием параметров SQL, переданных в <aParameters>. Указатель остается на строке с тем же физическим номером, или перемещается к последней физической строке.

13.3.4.29.3. Пример

rs := conn:CreateRowset("SELECT * FROM mytable")
rs:Browse()
rs:RefreshAll()
rs:Browse()

13.3.4.30.1. Описание

RefreshCurrent() обновляет текущую строку набора путем выполнения <cRefreshSQL>, переданного конструктору TConnect:CreateRowset(). Если <cRefreshSQL> - NIL, RefreshCurrent() ничего не делает.

13.3.4.30.2. Пример

rs := conn:CreateRowset("SELECT id,fname,lname FROM mytable",,,,,;
	"SELECT id,fname,lname FROM mytable WHERE id=:id")
? rs:Read()
rs:RefreshCurrent()
? rs:Read()

13.3.4.31.1. Параметры

13.3.4.31.2. Возвращаемое значение

.T. если строка с заданным ключом найдена; .F. - в противном случае

13.3.4.31.3. Описание

Seek() ищет первую логическую строку с ключом, равным <xKeyValue>. Если такая строка найдена, она становится текущей и Seek() возвращает .T.; иначе возвращается .F. и указатель перемещается следующим образом: при нормальном (не относительным) поиске указатель перемещается к последней логической строке и TRowset:Eof() возвращает .T.; при относительном поиске указатель перемещается к первой строке, ключевое значение которой больше чем заданное. Если такой строки не существует, указатель перемещается к последней логической строке и TRowset:Eof() возвращает .T.

Если нет управляющего индекса (созданного при помощи метода TRowset:CreateOrder() и установленного управляющим при помощи метода TRowset:SetOrder()),Seek() ничего не делает.

13.3.4.31.4. Пример

rs := conn:CreateRowset("SELECT fname,lname FROM mytable")
rs:CreateOrder("fname","fname",20)
rs:SetOrder("fname")
? rs:Seek("John")

13.3.4.32.1. Параметры

13.3.4.32.2. Возвращаемое значение

Имя текущего управляющего индекса или NIL (если нет управляющего индекса).

13.3.4.32.3. Описание

SetOrder() устанавливает индекс, созданный методом TRowset:CreateOrder(), управляющим. Возвращается имя ранее управляющего индекса.

Если передана пустая строка, SetOrder() снимает управляющий индекс, и доступ к строкам набора осуществляется в физическом порядке.

13.3.4.32.4. Пример

rs := conn:CreateRowset("SELECT fname,lname FROM mytable")
rs:CreateOrder("fname","fname",20)
rs:Browse() // browse rows in physical order
rs:SetOrder("fname")
rs:Browse() // browse rows ordered by first name
rs:SetOrder("")
rs:Browse() // browse in physical order again

13.3.4.33.1. Параметры

13.3.4.33.2. Описание

SetValue() присвает значение <xValue> заданному полю текущей строки.

В отличие от метода TRowset:Write() SetValue() не инициирует немедленного отражения изменения на SQL сервере (выполнения оператора <cUpdateSQL>, переданного конструктору класса TRowset TConnect:CreateRowset()). Отражение производится при первом же вызове метода, перемещающего указатель.

13.3.4.33.3. Пример

rs := conn:CreateRowset("SELECT fname,lname FROM mytable")
? rs:GetValue("fname") // John
rs:SetValue("fname","Sean")
? rs:GetValue("fname") // Sean

13.3.4.34.1. Параметры

13.3.4.34.2. Возвращаемое значение

Действительное число строк, на которое переместился указатель.

13.3.4.34.3. Описание

Skip() перемещает указатель в прямом или обратном направлении относительно текущей строки. При попытке переместить указатель в прямом направлении за последнюю логическую строку, указатель становится на последнюю логическую строку и TRowset:Eof() возвращает .T. При попытке переместить указатель в обратном направлении за первую логичускую строку, указатель становится на первую логическую строку и TRowset:Bof() возвращает .T.

13.3.4.34.4. Пример

rs := conn:CreateRowset("SELECT * FROM mytable")
while !rs:Eof()
	? rs:Read()
	rs:Skip()
enddo

13.3.4.35.1. Параметры

13.3.4.35.2. Описание

Write() присваивает новые значения полям текущей строки. Производится попытка отразить изменения на SQL сервере путем выполнения оператора <cUpdateSQL>, переданного конструктору класса TRowset TConnect:CreateRowset().

13.3.4.35.3. Пример

rs := conn:CreateRowset("SELECT id,fname,lname FROM mytable",,,,;
	"UPDATE mytable SET fname=:fname,lname=:lname WHERE id=:id")
oRow := map()
oRow:fname := "John"
oRow:lname := "Smith"
rs:Write(oRow)
? rs:GetValue("fname") // John
? rs:GetValue("lname") // Smith