Программирование на Delphi 7


         

Свойства и методы класса Tтаblеl



Таблица 16.8. Свойства и методы класса Tтаblеl

Объявление

Тип


 Описание

Свойства

property DataSource: TDataSource;

Pu, Ro

Ссылается на компонент TDataSource главного набора данных в отношении  главный/подчиненный

property Defaultlndex: Boolean;

Pb

Управляет сортировкой данных. При значении True записи упорядочиваются по первичному ключу. При значении False упорядочивание не производится

property Exclusive: Boolean;

Pb

Ограничивает доступ к таблице. При значении True с таблицей может работать только одно приложение. Это свойство важно при одновременной работе нескольких приложений с данными в локальной сети

property Exists: Boolean;

Pu, Ro

Значение True говорит о том, что связанная с компонентом таблица базы данных существует

property IndexDef s: TindexDefs;

Pb

Содержит информацию об индексах таблицы

property IndexFieldCount: Integer;

Pu, Ro

Возвращает число полей в текущем индексе таблицы

property IndexFieldNames: string;

Pb

Разделенный запятыми список названий полей, составляющих текущий индекс. Используется для таблиц серверов SQL

property IndexFields: [Index: Integer] : TField;

Pu

Индексированный список полей текущего индекса

property IndexFiles: TStrings;

Pb

Список индексных файлов для таблиц dBASE

property IndexName: string;

Pb

Определяет вторичный индекс для таблицы. Используется для таблиц локальных СУБД

property KeyExclusive: Boolean;

Pu

Управляет границами диапазона, задаваемого методом SetRange. При значении True крайние записи в диапазон не включаются

property KeyFieldCount: Integer;

Pu

Содержит число полей ключа, используемых при поиске. При значении 0 применяется только первое поле, при значении 1 — два первых поля и т. д. По умолчанию устанавливается полное число полей ключа

property MasterFields: string;

 Pb

Список имен полей главной таблицы, разделенных запятой, используемых при создании отношения главный/подчиненный

property MasterSource: TDataSource;

Pb

Содержит имя компонента TDataSource, связанного с набором данных, который является главным в отношении главный/подчиненный

property Readonly: Boolean;

Pb

Включает и отключает режим "только для чтения". В некоторых случаях набор данных можно открыть только в этом режиме

property StoreDef s: Boolean;

Pb

При значении True все сведения об индексах и структуре таблицы хранятся вместе с формой или модулем данных. В этом случае при создании набора данных одновременно создаются поля, индексы, ограничения

property TableLevel: Integer;

Pu

Содержит значение уровня таблицы, используемого в драйвере ВОЕ

property TableName: TFileName;

Pb

Определяет имя таблицы

type TTableType = (ttDefault, ttParadox, ttDBase, ttASCII, ttFoxPro) ;

property TableType: TTableType;

Pb

Определяет тип таблицы для стандартного драйвера ВОЕ. Значение ttDefault означает, что тип таблицы определяется по расширению файла

Методы

procedure Addlndex (const Name, Fields: string; Options: TIndexOptions) ;

Pu

Создает новый индекс. Параметр Name определяет имя нового индекса, параметр Fields — список полей индекса через запятую, параметр Options задает тип индекса

procedure ApplyRange;

Pu

Включает в работу границы диапазона, заданные методами SetRangeStart, SetRangeEnd или EditRangeStart, EditRangeEnd

type TBatchMode = (batAppend, batUpdate, batAppendUpdate , batDelete, batCopy) ;

function BatchMove (ASource: TBDEDataSet; AMode : TBatchMode) : Longint;

Pu

Переносит записи из таблицы ASource в набор данных. Тип операции задается параметром AMode. Возвращает число обработанных записей

procedure CancelRange;

procedure CloselndexFile (const  IndexFileName: string) ; 

Pu Pu 

Удаляет текущий диапазон

Закрывает индексный файл для таблиц dBASE

procedure CreateTable;

Pu

Создает новую таблицу, основываясь на данных о структуре таблицы, содержащихся в свойствах FieldDef s и indexDef s. Если свойство FieldDef s пустое, используется свойство Fields. Структура и данные существующей таблицы перезаписываются

procedure Deletelndex (const  Name: string); 

Pu

Удаляет вторичный индекс

procedure DeleteTable; 

Pu

Уничтожает таблицу базы данных. Набор данных при этом должен быть закрыт

procedure EditKey; 

Pu

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

procedure EditRangeEnd; 

Pu

Разрешает редактирование нижней границы диапазона

procedure EditRangeStart; 

Pu

Разрешает редактирование верхней границы диапазона

procedure EmptyTable; 

Pu

Удаляет все записи из набора данных

function FindKey (const  KeyValues: array of  const) : Boolean; 

Pu

Проводит поиск записи, значения полей которой удовлетворяют условиям, заданным параметром KeyValues. Значения разделяются запятыми. Для поиска можно использовать только поля, входящие в текущий индекс. Для локальных стандартных таблиц BDE это поля, определяемые свойством indexName. Для таблиц серверов SQL индекс можно задать свойством indexFieldNames. При успешном поиске функция возвращает значение True

procedure FindNearest (const KeyValues: array of  const);

Pu

Проводит поиск записи, значения полей которой, заданные параметром KeyValues, в минимальной степени отличаются от требуемых в большую сторону. Значения для поиска разделяются запятыми. Для поиска можно использовать толькополя, входящие в текущий индекс. Для  локальных стандартных таблиц ВОЕ  это поля, определяемые свойствомIndexName. Для таблиц серверов SQL индекс можно задать свойством indexFieldNames. При успешном поиске  функция возвращает True

procedure GetlndexNames (List : TStrings) ;

Pu

 Возвращает список индексов таблицы

procedure GotoCurrent (Table: TTable) ;

Pu

Синхронизирует курсор набора данных с курсором таблицы, заданной параметром Table

function GotoKey: Boolean;

Pu

Устанавливает курсор на запись, соответствующую значениям полей, заданным  при последнем применении метода

SetKey или EditKey

procedure GotoNearest;

Pu

Устанавливает курсор на запись, точно соответствующую значениям полей,  заданным при последнем применении метода SetKey или EditKey, или следующую ближайшую к ним по значениям

type TLockType = (ItReadLock, ItWriteLock) ; procedure LockTable ( LockType : TLockType) ;

Pu

Закрывает доступ к таблице Paradox или dBASE из других приложений

procedure OpenlndexFile (const IndexFileName: string);

Pu

Открывает индексный файл таблицы dBASE

procedure RenameTable (const NewTableName: string);

Pu

Переименовывает таблицу Paradox или dBASE

procedure SetKey;

Pu

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

procedure SetRange (const StartValues, EndValues:

array of const) ;

 

Pu

Задает диапазон отбора записей. Параметр StartValues определяет значения полей для верхней границы диапазона.

Параметр EndValues определяет значения полей для нижней границы диапазона. Значения диапазона задаются для полей текущего индекса

 procedure SetRangeEnd;

Pu

Задает нижнюю границу диапазона. После этого метода необходимо задать значения для полей текущего индекса, которые и будут нижней границей

procedure SetRangeStart;

Pu

Задает верхнюю границу диапазона. После этого метода необходимо задать значения для полей текущего индекса, которые и будут верхней границей

type TLockType = (ItReadLock, ItWriteLock) ; procedure UnlockTable (LockType : TLockType) ;

Pu

Разблокирует таблицу Paradox или dBASE для доступа из других приложений



Содержание раздела