Методы объекта xBase СоздатьФайл

Создать новый файл базы данных.

Синтаксис:

СоздатьФайл(<ПутьКБазе>, <ПутьКИндексу>)

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

CreateFile

Параметры:

<ПутьКБазе>	Строковое выражение, содержащее путь к файлу базы данных формата DBF.
<ПутьКИндексу>	Необязательный параметр. Строковое выраже­ние, содержащее путь к индексному файлу базы данных.

Описание:

Метод СоздатьФайл создает новый файл базы данных формата DBF. Если база с таким именем существует, то выдается ошибка.

Пример:

ДБФ = СоздатьОбъект("XBase");

// Определение полей и индексов новой БД

.....................

.....................

// Теперь физически создаем базу

ДБФ.СоздатьФайл("mydb.dbf", "mydb.cdx");

См. также: ДобавитьПоле, ДобавитьИндекс

ОткрытьФайл

Открыть существующую базу.

Синтаксис:

ОткрытьФайл(<ПутьКБазе>, <ПутьКИндексу>, <ТолькоЧтение>)

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

OpenFile

Параметры:

<ПутьКБазе>	Строковое выражение, содержащее путь к файлу базы данных формата DBF.
<ПутьКИндексу>	Необязательный параметр. Строковое выражение, содержащее путь к индексному файлу базы дан­ных.
<ТолькоЧтение>	Необязательный параметр. Число: 1 — файл от­крывается в режиме только чтение; 0 — файл открывается в режиме полного доступа (при этом файл открывается в эксклюзивном режиме). Значение по умолчанию — 0.

Описание:

Метод ОткрытьФайл открывает существующую базу данных формата DBF.

Пример:

// Подразумевается, что объект ДБФ уже создан и

// доступен в данном контексте

Процедура ОткрДБ()

ИмяФайла = "";

ИмяПути = "";

ФС.ВыбратьФайл(0, ИмяФайла, ИмяПути, , "*.*", , );

ПутьДБ = ИмяПути + ИмяФайла;

ДБФ.ОткрытьФайл(ПутьДБ);

Если ДБФ. Открыта() = 1 Тогда

Предупреждение("База открыта", 2);

Иначе

Предупреждение("Не смогли открыть Базу!", 2);

КонецЕсли;

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

Открыта

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

Синтаксис:

Открыта()

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

IsOpen

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

Число: 1 — база открыта; 0 — база не открыта.

Описание:

Метод Открыта возвращает значение флага открытия файла базы данных.

Пример:

См. предыдущий пример.

ЗакрытьФайл

Закрыть базу.

Синтаксис:

ЗакрытьФайл()

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

CloseFile

Описание:

Метод ЗакрытьФайл закрывает ранее открытую или созданную базу дан­ных формата DBF.

Пример:

Процедура ЗакрДБ()

Если ДБФ.Открыта() = 1 Тогда

ДБФ.ЗакрытьФайл();

КонецЕсли;

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

ОчиститьФайл

Очистить все записи в базе.

Синтаксис:

ОчиститьФайл()

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

Zap

Описание:

Метод ОчиститьФайл удаляет все записи в базе. При этом все существую­щие записи удаляются физически и не могут быть впоследствии восстановле­ны.

Пример:

Процедура ОчистДБ()

Если Вопрос("Вы уверены, что надо очистить базу?", 1, 5) = 1 Тогда

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

КонецЕсли;

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

См. также: Удалить, Восстановить

Сжать

Сжать базу, убрать удаленные записи.

Синтаксис:

Сжать()

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

Pack

Описание:

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

Пример:

Процедура СжатьДБ()

Если Вопрос("Уничтожить записи, помеченные как удаленные?", 1, 5) = 1 Тогда

ДБФ.Сжать();

КонецЕсли;

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

См. также: Удалить, Восстановить