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

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

Синтаксис:

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

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

FindByKey

Параметры:

<Режим>

Числовое выражение. Режим поиска записей: 0 — ищет запись на точное соответствие ключу (=); 1 — ищет запись на точное соответствие с ключом или большую (>=); 2 — ищет запись с большим ключом (>); -1 (минус единица) — ищет запись на точное соответ­ствие с ключом или меньшую(<=); -2 (минус два) — ищет запись с меньшим ключом (<).

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

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

Описание:

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

Пример:

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

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

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

ПолучитьЗначениеПоля

Получить значение поля записи.

Синтаксис:

ПолучитьЗначениеПоля(<НазваниеПоля>)

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

GetFieldValue

Параметры:

<НазваниеПоля>

Строковое выражение с названием поля или число­вое выражение с номером поля.

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

Значение поля записи, тип зависит от типа поля.

Описание:

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

Пример:

Процедура ПерНаЗап(НЗап)

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

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

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

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

КонецЦикла;

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

УстановитьЗначениеПоля

Установить значение поля.

Синтаксис:

УстановитьЗначениеПоля(<НазваниеПоля>, <Значение>)

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

SetFieldValue

Параметры:

<НазваниеПоля>	Строковое выражение с названием поля или чи­словое выражение с номером поля.
<Значение>	Значение поля.

Описание:

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

Пример:

ДБФ.УстановитьЗначениеПоля(НаименованиеПоля, 1234);

Добавить

Добавить новую пустую запись.

Синтаксис:

Добавить()

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

Add

Описание:

Метод Добавить добавляет новую пустую запись. Атрибуты объекта обну­ляются (см. метод Очистить). Для записи изменений в базу данных необходи­мо инициировать запись (см. «Назначение агрегатного типа данных Xbase»).

Пример:

Процедура ДобЗап(Поле!, Поле2)

ДБФ.Добавить();

// Определяем поля новой записи

ДБФ.FIELD1 = Поле1;

ДБФ.FIELD2 = Поле2;

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

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