Методы
Синтаксис:
ВКонце()
Возвращаемое значение:
Тип: Булево. Истина - указатель в файле находится за последней записью; Ложь - конец файла не достигнут.
Описание:
Получает признак достижения указателем текущей записи конца файла.
Пример:
// Максимальное значение поля COST
хВ.Первая() ;
МаксСтоимость = 0 ;
Пока Не хВ.ВКонцеО Цикл
Если xB.COST > МаксСтоимость Тогда
МаксСтоимость = xB.COST;
КонецЕсли ;
хВ.Следующая();
КонецЦикла;
Синтаксис:
ВНачале()
Возвращаемое значение:
Тип: Булево. Истина - указатель в файле находится перед первой записью; Ложь - начало файла не достигнуто.
Описание:
Получает признак достижения указателем текущей записи начала файла.
Пример:
// Среднее значение поля COST
хВ.Последняя();
Стоимость = 0;
Записей =0;
Пока Не хВ.ВНачале() Цикл
Стоимость = Стоимость + xB.COST;
Записей = Записей +1;
хВ.Предыдущая();
КонецЦихла;
Если Записей > 0 Тогда
Стоимость = Стоимость / Записей ;
КонецЕсли;
Синтаксис:
Восстановить()
Описание:
Снимает с текущей записи пометку удаления.
Пример:
// Восстановление всех удаленных записей
хВ.ПоказыватьУдаленные = истина;
хВ.Первая();
Пока Не хВ.Вконце() Цикл;
хВ. Восстановить();
хВ.Следующая();
КонецЦикла; .
Синтаксис:
Добавить()
Описание:
Добавляет новую пустую запись. При этом поля и свойства объекта Ключ очищаются. Для записи изменений в таблицу базы данных необходимо инициировать запись.
Пример:
хВ.Добавить();
xB.CODE = "00004";
xB.NAME = "Клавиатура";
хВ.Записать();
Синтаксис:
ЗакрытьФайл()
Описание:
Закрывает ранее открытую или созданную таблицу базы данных формата DBF.
Пример:
Если хВ.Открыта() Тогда;
хВ.ЗакрытьФайл();
КонецЕсли;
Записать (Save)
Синтаксис:
Записать()
Описание:
Выполняет запись изменений в таблицу базы данных. До его вызова все изменения объекта производились только в памяти и будут потеряны при осуществлении перехода к другой записи или закрытии таблицы базы данных, если отключен режим автосохранения.
См. также:
XBase, свойство Автосохранение.
ЗаписьУдалена (RecDeleted)
Синтаксис:
ЗаписьУдалена()
Возвращаемое значение:
Тип: Булево. Истина - запись удалена; Ложь - запись не удалена.
Описание:
Получает пометки удаления текущей записи.
Пример:
хВ.ПоказыватьУдаленные = Истина;
хВ.Первая();
Пока Не хВ.ВконцеО Цикл
Если хВ.ЗаписьУдалена () Тогда
Сообщить("Удаленная запись: " + хВ.НомерЗаписи());
КонецЕсли;
хВ.Следующая();
КонецЦикла;
КодОшибки (ErrorCode)
Синтаксис:
КодОшибки()
Возвращаемое значение:
Тип: Число. Код последней ошибки. Возвращаемые коды ошибок:
• -10 - Ошибка закрытия файла;
• -20 - Ошибка создания файла;
• -30 - Ошибка определения длины файла;
• -40 - Ошибка установки длины файла;
• -50 - Ошибка при попытке заблокировать файл;
• -60 - Ошибка при открытии файла;
• -70 - Ошибка чтения файла;
• -80 - Ошибка удаления файла;
• -90 - Ошибка переименования файла;
• -100 - Ошибка позиционирования в файле;
• -110 - Ошибка снятия блокировки с файла;
• -120 - Ошибка записи в файл;
• -200 - Файл не является базой данных DBF-формата;
• -210 - Неопознанное имя поля;
• -220 - Неопознанный тип поля;
• -230 - Запись слишком длинная;
• -300 - Индексный файл не содержит информации о записи;
• -310 - Нарушение структуры индексного файла;
• -330 - Указанное имя индекса недоступно;
• -340 - Ошибка уникальности индекса;
• -400 - Ожидается запятая или скобка;
• -410 - Выражение не завершено;
• -422 - IIF() требует параметров одинаковой длины;
• -425 - У STR() и SUBSTR() 2-й и 3-й параметры - константы;
• -430 - Неверное число параметров;
• -440 - Слишком сложное выражение;
• -450 - Пропущена правая скобка;
• -460 - Неверный тип подвыражения;
• -470 - Неопознанная функция;
• -480 - Неопознанный оператор;
• -490 - Неопознанное значение;
• -500 - Выражение не завершено символом двойной кавычки;
• -920 - Недостаточно памяти.
Описание:
Получает код завершения последней выполненной операции.
Пример:
Если хВ.КодОшибки () = -60 Тогда
Сообщить("Не удалось открыть файл DBF");
КонецЕсли ;
КоличествоЗаписей (RecCount)
Синтаксис:
КоличествоЗаписей()
Возвращаемое значение:
Тип: Число. Количество записей в базе.
Описание:
Получает количество записей в таблице базы данных вместе с помеченными на удаление записями.
Пример:
Предупреждение(" Записей " + Строка (хВ.КодичествоЗаписей ()));
Найти (Find)
Синтаксис:
Найти(<Ключ>, <Режим>)
Параметры:
<Ключ> Обязательный
Тип: Строка. Значение выражения текущего индекса.
<Режим> Обязательный
Тип: Строка. Режим поиска записей:
"=" - ищет запись на точное соответствие ключу;
">=" - ищет запись на точное соответствие с ключом или большую;
">" - ищет запись с большим ключом;
"<=" - ищет запись на точное соответствие с ключом или меньшую;
"<" - ищет запись с меньшим ключом.
Возвращаемое значение:
Тип: Булево. Истина - запись найдена; Ложь - запись не найдена.
Описание:
Позволяет найти запись, соответствующую указанному значению ключа по текущему индексу и режиму поиска, переданному в качестве параметра. Указатель устанавливается на найденную запись.
Примечание:
Следует отметить, что вычисление значения индекса при работе XBase-объекта с таблицей базы данных производится объектом самостоятельно на основании выражения, переданного ему при создании ключа. При вызове данного метода значение Ключ должно быть вычислено средствами встроенного языка, что может представлять определенные трудности, если индекс составной, поля, включенные в выражение индекса, отличны от строковых, и т.д. Поэтому применимость данного метода ограничена случаем использования простых строковых выражений индекса. В более сложных случаях следует применять универсальный метод НайтиПоКлючу.
Пример:
// Поиск записи по значению ключа
хВ.ТекущийИндекс = хВ.Индексы.IDXCODE; // индекс CODE
ЗаписьНайдена = хВ.Найти("00001" , ">=");
См. также:
XBase, свойство ТекущийИндекс.
НайтиПоКлючу (FindByKey)
Синтаксис:
НайтиПоКлючу (< Режим> )
Параметры:
<Peжим> Обязательный
Тип: Строка. Режим поиска записей:
"=" - ищет запись на точное соответствие ключу;
">=" - ищет запись на точное соответствие с ключом или большую;
">" - ищет запись с большим ключом;
"<=" - ищет запись на точное соответствие с ключом или меньшую;
"<" - ищет запись с меньшим ключом.
Возвращаемое значение:
Тип: Булево. Истина - запись найдена; Ложь - запись не найдена.
Описание:
Позволяет найти запись, соответствующую значениям свойств объекта типа Ключ XBase-объекта по текущему индексу и режиму поиска, переданному в качестве параметра. Указатель устанавливается на найденную запись. Перед вызовом метода следует установить значения всех свойств объекта типа Ключ, которые участвуют в вычислении выражения текущего индекса.
Пример:
// Поиск по составному ключу
хВ.ТекущийИндекс = хВ.Индексы.IDXCNAME; // индекс CODE + TRIM(NAME)
хВ.Ключ. CODE = "00001";
хВ.Ключ. NAME = "Системный блок";
ЗаписьНайдена = хВ.НайтиПоКлючу("=");
См. также:
XBase, свойство Ключ. XBase, свойство ТекущийИндекс.
НомерЗаписи (RecNo)
Синтаксис:
НомерЗаписи()
Возвращаемое значение:
Тип: Число. Номер текущей записи.
Описание:
Получает физический порядковый номер текущей записи в таблице базы данных, начиная с единицы. Результат не зависит от установки текущего индекса.
Пример:
Если хВ.ЗаписьУдалена() Тогда
Сообщить ("Удаленная запись: " + хВ. НомерЗаписи());
КонецЕсли;
| «««««««««« | 1С:Предприятие 8.0 | »»»»»»»»»» |
