Следующая

Перейти на следующую запись.

Синтаксис:

Следующая()

Англоязычный синоним:

Next

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

Число: 1 — получена следующая запись; 0 — следующая запись не найдена.

Описание:

Метод Следующая предназначен для позиционирования объекта на сле­дующую запись. В зависимости от того, установлен ли текущий индекс, пози­ционирование происходит либо в порядке возрастания физического номера записи, либо в порядке возрастания значения выражения текущего индекса (если индекс создавался с установленным флагом "Убывание", то в порядке убавания).

Пример:

// Обнуляет значения всех полей всех существующих записей

Процедура ОчистЗап() ДБФ.Первая();

Пока 1 = 1 Цикл

ДБФ.Очистить();

ДБФ.Записать();

Если ДБФ.Следующая() = 0 Тогда

Возврат;

КонецЕсли;

КонецЦикла;

КонецПроцедуры

Предыдущая

Перейти на предыдущую запись.

Синтаксис:

Предыдущая()

Англоязычный синоним:

Prev

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

Число: 1 — получена предыдущая запись; 0 — предыдущая запись не найде­на.

Описание:

Метод Предыдущая предназначен для перехода на предыдущую запись. В зависимости от того, установлен ли текущий индекс, позиционирование проис­ходит либо в порядке убывания физического номера записи, либо в порядке убывания значения выражения текущего индекса (если индекс создавался с Установленным флагом «Убывание», то в порядке возрастания).

Пример:

См. пример метода Последняя

НомерЗаписи

Возвращает значение номера текущей записи.

Синтаксис:

НомерЗаписи()

Англоязычный синоним:

RecNo

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

Числовое значение — номер текущей записи.

Описание:

Метод НомерЗаписи возвращает физический порядковый номер текущей записи в файле базы данных. Результат не зависит от установки текущего ин­декса.

Пример:

Процедура ПоказатьНомераУдалЗап()

РежПокУд = ДБФ.ПоказыватьУдаленные(1);

ДБФ.Первая();

Пока ДБФ.Вконце() = 0 Цикл

Если ДБФ.ЗаписьУдалена() = 1 Тогда

Стр1 = "Номер удаленной записи — ";

Стр2 = Строка(ДБФ.НомерЗаписи());

Предупреждение(Стр1 + Стр2, 3);

КонецЕсли;

Если ДБФ.Следующая() = 0 Тогда

Прервать;

КонецЕсли;

КонецЦикла;

ДБФ.ПоказыватьУдаленные(РежПокУд);

КонецПроцедуры

См. также: Перейти

Перейти

Перейти на запись по ее номеру записи.

Синтаксис:

Перейти(<НомерЗаписи>)

Англоязычный синоним:

GoTo

Параметры:

<НомерЗаписи>

Числовое выражение — физический порядковый номер записи в базе данных.

Описание:

Метод Перейти позволяет перейти на запись по ее физическому порядко­вому номеру в базе данных. Позволяет перейти на запись, помеченную удален­ной, даже если не установлен режим просмотра удаленных записей.

Пример:

Процедура ИнформацияОЗаписи(НЗап)

ДБФ.Перейти(НЗап);

Стр3ап = "н." + ДБФ.НомерЗаписи();

Стр3ап = Стр3ап + " Уд. " + ДБФ.ЗаписьУдалена();

Стр3ап = СтрЗап + " Содержит -";

Для КП = 1 По ДБФ.КоличествоПолей() Цикл

СтрЗап = СтрЗап + Строка(ДБФ.ПолучитьЗначениеПоля(КП)) + "; ";

КонецЦикла;

Предупреждение(СтрЗап, 10);

КонецПроцедуры

См. также: НомерЗаписи

ВКонце

Прочитать значение флага конца файла базы банных.

Синтаксис:

ВКонце()

Англоязычный синоним:

EOF

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

Число: 1 — указатель в файле находится за последней записью; 0 — конец файла не достигнут.

Описание:

Метод ВКонце возвращает значение флага конца файла.

Пример:

Функция МаксимальнаяПокупка()

ДБФ.Первая();

Уплачено = 0;

Пока ДБФ.Вконце() = 0 Цикл

Если ДБФ.AMOUNT > Уплачено Тогда

Уплачено = ДБФ.AMOUNT;

КонецЕсли;

ДБФ.Следующая();

КонецЦикла;

Возврат Уплачено;

КонецПроцедуры