Иллюстрированный самоучитель по языку системы 1С:Предприятие › Работа с базами данных формата DBF › Методы объекта XBase [страница - 1134] | Самоучители по бухгалтерским программам

Иллюстрированный самоучитель по языку системы 1С:Предприятие

Методы объекта XBase

НайтиПоКлючу

Найти запись по индексу.

Синтаксис:

НайтиПоКлючу(<Режим>)

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

FindByKey

Параметры:

<Режим>

Числовое выражение. Режим поиска записей:

0 – ищет запись на точное соответствие ключу (=);
1 – ищет запись на точное соответствие с ключом или большую (>=);
2 – ищет запись с большим ключом (>);
-1 (минус единица) – ищет запись на точное соответствие с ключом или меньшую(<=);
-2 (минус два) – ищет запись с меньшим ключом (<).

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

Число: 1 – если действие выполнено (запись найдена); 0 – если действие не выполнено.

Описание:

Метод НайтиПоКлючу позволяет найти запись, соответствующую значениям атрибутов агрегатного объекта типа "Ключ" XBase-объекта по текущему индексу и режиму поиска, переданному в качестве параметра. Указатель устанавливается на найденную запись. Перед вызовом метода следует установить значения всех атрибутов агрегатного объекта типа "Ключ", которые участвуют в вычислении выражения текущего индекса (см. описание метода ДобавитьИндекс).

Пример:

ДБФ.Ключ.Name = "Иванов";

ДБФ.Ключ.DIV_ID = 15; // отдел новых разработок

ЗаписьНайдена = ДБФ.НайтиПоКлючу(0); // поиск по составному, неоднородному ключу