function LocateRecord(const KeyFields: string; const KeyValues: Variant; Options: TLocateOptions; bSyncCursor: Boolean): Boolean;

Це внутрішній метод, який виробляє всю дійсну роботу з пошуку.

1.25 IsDeleted

function IsDeleted: Boolean;

Викличте функцію IsDeleted для перевірки, що поточна запис позначена як віддалена. Ця функція діє, якщо властивість ShowDeleted встановлено у true.

1.26 Undelete

procedure Undelete;

Викличте процедуру Undelete для зняття позначки про видалення.

1.27 CreateTable

procedure CreateTable;

Викличте процедуру CreateTable під час виконання для створення таблиці, використовуючи поточні визначення набору даних. Якщо таблиця вже існує, то процедура CreateTable перезапише структуру таблиці і дані. Якщо властивість FieldDefs містить значення, ці значення використовуються для створення визначень полів. Інакше буде використано властивість Fields. Одне або декілька з цих властивостей може містити значення для створення таблиці. Якщо властивість Indexes містить значення, то ці значення використовуються для створення індексів у таблиці. Див Також CreateTableEx.

1.28 CreateTableEx

procedure CreateTableEx(DbfFieldDefs: TDbfFieldDefs);

Викличте процедуру CreateTableEx для створення таблиці, використовуючи дані визначення полів. Дані визначення полів дають більше можливостей, наприклад, таких як визначення точності цифрових полів.

1.29 CopyFrom

procedure CopyFrom(DataSet: TDataSet; FileName: string;

DateTimeAsString: Boolean; Level: Integer);

Використовуйте дану процедуру для копіювання заданого набору даних в нову таблицю. Параметр DataSet це тип TDataSet, з якого ви хочете скопіювати, FileName це повне ім'я нової таблиці (включаючи шлях і розширення). DateTimeAsString вказує, що поля datetime повинні бути перетворені в рядкові поля в таблиці результату. Це особливо корисно якщо ви бажаєте використовувати TDbf для створення до текстових процесорів наприклад. Якщо цей параметр встановлений в True, то спрацьовує обробник події OnCopyDateTimeAsString, де ви можете перекрити стандартне перетворення з datetime в string, яке базується на поточних регіональні настройки. Властивість Level визначає TableLevel для нової таблиці.

У разі використання версій TDbf до 6.0 для перетворення datetime значень в BDE сумісний формат, використовуйте цю процедуру наступним чином: помістіть два примірники TDbf на форму, встановіть у TDbf1 властивість DateTimeHandling в dtDateTime і підключіть до існуючої таблиці. Переконайтеся, що у TDbf2 воно встановлено в dtBDETimeStamp і викличте процедуру CopyFrom з DataSet = TDbf1 і DateTimeAsString = False. Потім Ви можете замінити стару таблицю новою і використовувати TDbf в режимі dtBDETimeStamp у ваших додатках.

1.30 RestructureTable

procedure RestructureTable(DbfFieldDefs: TDbfFieldDefs; Pack: Boolean);

Викличте процедуру RestructureTable для зміни структури поточної таблиці.

Параметр DbfFieldDefs дозволяє вказати нову структуру. Кожен елемент FieldDef містить властивість CopyFrom, яке є індексом поля з якого копіюється інформація. Поля, з які не вказується в жодному з DbfFieldDef властивостей CopyFrom, видаляються. Якщо ви призначили копію визначення таблиці DbfFieldDefs новому списку для модифікації, то властивість CopyFrom нового списку FieldDefs автоматично призначається, виключаючи Delphi 3 користувачів. Тому користувачі Delphi 3 повинні потурбуватися призначенням властивості CopyFrom для запобігання видалення полів, чого природно ви не хочете! Параметр Pack вказує необхідність упаковки таблиці, для видалення записів позначених для видалення.

1.31 PackTable

procedure PackTable;

Викличте процедуру PackTable для остаточного видалення записів позначених для видалення. Перед тим як ці записи будуть остаточно видалені, вони позначаються до видалення. Виклик процедури PackTable видаляє ці записи фізично з таблиці. Також це можна зробити за допомогою виклику процедури RestructureTable з покажчиком nil для установки DbfFieldDefs і передачею true для Pack.

1.32 EmptyTable

procedure EmptyTable;

Метод EmptyTable видаляє всі записи з таблиці. Він не змінює поточну структуру таблиці та індексів.

1.33 Zap

procedure Zap;

Псевдонім для методу EmptyTable.

1.34 InitFieldDefsFromFields

{$ifndef DELPHI_5}

procedure InitFieldDefsFromFields;

{$endif}

Це внутрішній метод InitFieldDefsFromFields, що використовується різними функціями, наприклад, CreateTable. Він створює визначення полів для існуючого набору Fields. Дана процедура нудна тільки для Delphi 4 і молодше, оскільки в Delphi 5 і старше дана процедура реалізована в TDataSet.

2. Властивості

2.1 AbsolutePath

property AbsolutePath: string read FAbsolutePath;

Це абсолютний шлях до поточної таблиці. Див також FilePathFull.

2.2 DbfFieldDefs

property DbfFieldDefs: TDbfFieldDefs read GetDbfFieldDefs;

DbfFieldDefs це список визначень полів для таблиці, подібний до TDataSet.FieldDefs, за винятком того, що TDbfFieldDefs більш підходить для dBase таблиць. Наприклад, він включає інформацію про рідних типах полів і точність для числових полів. Див також TDbfFieldDefs. Для доступу до полів і їх значень в наборі даних використовуйте властивості Fields і Field Values, а також метод FieldByName.

2.3 PhysicalRecNo

property PhysicalRecNo: Integer read GetPhysicalRecNo write SetPhysicalRecNo;

Використовуйте властивість PhysicalRecNo для визначення фізичного номера запису поточного запису. Його також можна використовувати для встановлення курсору на потрібний запис. Різниця між RecNo полягає в тому, що читання RecNo повертає послідовний номер, який той же самий якщо індекс не використовується і розрізняється якщо індекс використовується.

2.4 LanguageID

property LanguageID: Integer read GetLanguageID;

Використовуйте властивість LanguageID для визначення кодової сторінки, комбінації про використану локалізації using. Див також DbfLang.pas для отримання інформації.

2.5 LanguageStr

property LanguageStr: String read GetLanguageStr;

Використовуйте властивість LanguageStr для читання кодової сторінки, інформації про локалізацію для dBase таблиць рівня 7.

2.6 CodePage

property CodePage: Cardinal read GetCodePage;

Використовуйте властивість CodePage для визначення кодової сторінки dBase таблиці.

2.7 ExactRecordCount

property ExactRecordCount: Integer read GetExactRecordCount;

Використовуйте властивість ExactRecordCount для визначення точної кількості записів у поточному наборі даних. Воно включає в себе кількість видалених, відфільтрованих і індексованих записів. Цим воно відрізняється від властивості RecordCount, яке завжди дає існуючу верхньої межі. Зауважимо, що дана властивість вимагає сканування повного набору даних, у той час як властивість RecordCount це просто розрахунок.

2.8 DbfFile

property DbfFile: TDbfFile read FDbfFile;

Ця властивість використовується внутрішньо для функцій нижнього рівня.Додатку користувача немає потреби звертатися до даного властивості.

2.9 DisableResyncOnPost

property DisableResyncOnPost: Boolean read FdisableResyncOnPost

write FDisableResyncOnPost ;

Коли запис записується в таблицю, TDataSet витягує всі записи поблизу від поточного запису. Властивість DisableResyncOnPost керує даним поведінкою. Воно дозволяє збільшити швидкість, якщо Ви додаєте групу записів. Див також TDataSet.DisableControls.

2.10 DateTimeHandling

property DateTimeHandling: TDateTimeHandling read FdateTimeHandling

write FDateTimeHandling default dtBDETimeStamp;

До версії 6.0 TDbf використовував запис значення в '@' (ftDateTime) полів як Delphi тип TDateTime. Для сумісності з BDE, ці поля треба було записувати як BDE тип TimeStamp (число мілісекунд, починаючи з 01/01/0001 плюс один день). Для забезпечення сумісності Ви можете використовувати цю властивість для визначення як TDbf повинен читати і писати значення datetime як TDateTime або як BDE TimeStamp. Зараз за замовчуванням це як dtBDETimeS - tamp, але для читання значень в існуючих TDbf таблицях Ви можете вибрати тип dtDateTime. Якщо ви бажаєте перетворити ваші дані, сумісні з BDE, то зверніть вашу увагу на процедуру CopyFrom.

2.11 Exclusive

property Exclusive: Boolean read FExclusive write FExclusive default false;

Використовуйте властивість Exclusive для запобігання доступу інших додатків до таблиці, відкритої в цьому додатку. Перед відкриттям таблиці, встановіть властивість Exclusive в true. Таблиця повинна бути закрита до зміни властивості Exclusive. Коли властивість Exclusive встановлено у true, і додаток успішно відкрило таблицю, то інші програми не зміг мати до неї доступу. Якщо таблиця, до якої потрібно монопольний доступ, вже відкрита іншим додатком, то виникне виняток. Для обробки таких винятків, укладіть відкриття в блок try except end. Див також TryExclusive. Не встановлюйте властивість Exclusive в true під час розробки, якщо Ви одночасно встановлюєте властивість Active в true. В цьому випадку відбудеться виключення, оскільки таблиця вже використовується в IDE.

2.12 FilePath

property FilePath: string read FRelativePath write SetFilePath;

Використовуйте властивість FilePath для визначення, який шлях встановив користувач до файлу поточної таблиці. Він може бути або відносним або абсолютним. Див також FilePathFull.

2.13 FilePathFull

property FilePathFull: string read FAbsolutePath write SetFilePath

stored false;

Використовуйте властивість FilePathFull для визначення абсолютного шляху для поточної таблиці. Воно завжди містить абсолютний шлях, незалежно який шлях вказаний у властивості FilePath. Звичайно це використовується під час розробки в IDE, коли ви встановлюєте відносний шлях у властивості FilePath, потім перевіряєте властивість FilePathFull щоб визначити де буде створена чи відкрита таблиця.

2.14 Indexes

property Indexes: TDbfIndexDefs read FIndexDefs write SetDbfIndexes;

Властивість Indexes це колекція визначень індексів, кожен елемент якої описує окремий індекс для таблиці. Визначайте визначення індексу до виклику процедури CreateTable або створення таблиці під час розробки в середовищі. Зазвичай додаток робить доступ або вказує індекси під час виконання, через властивості IndexName і IndexFieldNames. Якщо властивість Indexes оновлюється або вручну редагується, то властивість StoreDefs встановлюється в true. Визначення індексу у властивості Indexes не завжди відображає поточні індекси доступні для таблиці. Перед перевіркою властивості Indexes, викличте метод Update для оновлення списку.

2.15 IndexFieldNames

property IndexFieldNames: string read GetIndexFieldNames

write SetIndexFieldNames;

Використовуйте властивість IndexFieldNames як альтернативний метод для визначення індексу використовуваного для таблиці. У властивості IndexFieldNames, вкажіть ім'я кожної використовуваної колонки як індекс для таблиці. Ви можете також вказати вираз для існуючого індексу. Назва колонки, зазначене у властивості IndexFieldNames повинно бути вже проіндексовано. Властивості IndexFieldNames і IndexName взаємно виняткові. Установка одного очищає інше.

2.16 IndexName

property IndexName: string read GetIndexName write SetIndexName;

Використовуйте властивість IndexName для вказівки альтернативного індексу для таблиці. Якщо властивість IndexName пусто, то сортування здійснюється з фізичного порядку записів у таблиці. Якщо IndexName містить ім'я допустимого індексу, то індекс визначає сортування записів. Назва індексу, зазначене у властивості IndexName має бути або в головному індексному файлі таблиці або в іншому індексному фото, вже зазначеному у властивості Indexes або відкритому за допомогою функції OpenIndexFile. IndexFieldNames і IndexName є взаємовиключними. Налаштування одного очищає інше.

2.17 MasterFields

property MasterFields: string read GetMasterFields write SetMasterFields;

Використовуйте властивість MasterFields після установки властивості MasterSource вкажіть назву одне або більше полів для створення зв'язку основна підпорядкована між цією таблицею та таблицею зазначеної у властивості MasterSource. Властивість MasterFields це рядок, що містить одну або більше імен полів в основній таблиці. Поля розділяються символів крапку з комою. Кожен раз, коли поточний запис змінюється в головній таблиці, то нове значення цих полів використовується для вибору відповідних записів у підпорядкованій таблиці.

2.18 MasterSource

property MasterSource: TDataSource read GetDataSource write SetDataSource;

Використовуйте властивість MasterSource вкажіть назву компонента, чиє властивість DataSet використовується як головна таблиця для встановлення зв'язку з підлеглою.Вказане властивість DataSource має бути інший TDbf таблицею. Під час розробки виберіть доступне джерело з меню, що випадає властивості MasterSource в інспектора об'єктів. Після установки властивості MasterSource вкажіть, які поля використовуються в головній таблиці через установку властивості MasterFields. Під час виконання, кожен раз, коли поточний запис у головній таблиці змінюється, нове значення використовується для вибору відповідних записів у підпорядкованій таблиці.

2.19 OpenMode

property OpenMode: TDbfOpenMode read FOpenMode write FopenMode

default omNormal;

Властивість OpenMode вказує, що робити, якщо зазначена з даним ім'ям таблиці не існує і властивість Active в встановлюється істинне або викликається метод відкритим.

· Значення omNormal перериває відкриття, якщо файл не існує.

· Значення omAutoCreate створює нову таблицю, якщо викликається метод CreateTable і відкриває її.

· Значення omTemporary не використовується.

2.20 ReadOnly

property ReadOnly: Boolean read FReadOnly write FReadonly

default false;

Властивість ReadOnly вказує, що таблицю треба відкрити в режимі тільки читання. Якщо це властивість встановлено в True, то таблицю не можна змінювати. Ви можете відкрити таблицю в режимі тільки читання, навіть якщо вона відкрита в монопольному режимі.

2.21 ShowDeleted

property ShowDeleted: Boolean read FShowDeleted write SetShowDeleted

default false;

Властивість ShowDeleted вказує показувати записи, позначені для видалення чи ні. Використовуйте функцію IsDeleted для визначення, що поточна запис позначена для видалення.

2.22 Storage

property Storage: TDbfStorage read FStorage write FStorage default stoFile;

Властивість не використовується.

2.23 StoreDefs

property StoreDefs: Boolean read FStoreDefs write FStoreDefs default False;

StoreDefs якщо властивість встановлено в True, то визначення індексів таблиці та її полів записуються разом з модулем даних або формою. Установка властивості StoreDefs в істинно робить можливим створення полів, індексів методом CreateTable простою справою, за один дзвінок під час виконання програми. Властивість StoreDefs за замовчуванням встановлено в помилковими. Воно встановлюється в Щоправда, коли властивості FieldDefs або індекси оновлюється або редагується вручну; для запобігання запису змінених або імпортованих визначень не забудьте скинути це властивість в помилковими.

2.24 TableName

property TableName: string read FTableName write SetTableName;

Використовуйте властивість TableName вкажіть назву файлу таблиці бази даних. Ви можете вказати або повний шлях з ім'ям файлу, в цьому випадку шлях буде відділений і записаний в властивість FilePath. При установці TableName, властивість Active повинно бути в змозі помилковою.

2.25 TableLevel

property TableLevel: Integer read FTableLevel write SetTableLevel;

Використовуйте властивість TableLevel для визначення рівня поточної таблиці. Установка властивості TableLevel дозволяє вказати рівень для знову створюваних таблиць.Властивість Active повинно бути в змозі помилкової під час встановлення цієї властивості.Існують такі рівні:

· сумісність з DBase III +

· сумісність з DBase IV. Єдина різниця в DBase III + це поточна кодова сторінка, локалізація DBase III + не використовує перетворення для кодової сторінки і використовує двійковий порядок для сортування.

· сумісність з Visual DBase VII. Не всі властивості підтримані, але тут наведено підтримані:

- Більше типів полів: DateTime, 32-бітні цілі, 64-бітові подвійної точності.

- Значення за замовчуванням для полів. Ця інформація доступна через властивості DbfFieldDef, .HasDefault і DefaultBuf.

- Значення min і max для полів не підтримані, але можуть бути прочитані.

- Посилальна цілісність не підтримана.

· Сумісність з FoxPro. Ці типи трохи розрізняються, але дуже сумісні з DBase IV. CDX індекси не підтримані.

2.26 UseFloatFields

property UseFloatFields: Boolean read FUseFloatFields write FuseFloatFields

default true;

Коли властивість UseFloatFields дозволено, то це змушує використовувати поля з плаваючою комою, навіть якщо числові поля мають нульову точність. Коли заборонено, то використовуються 32 або 64 бітові цілочисельні поля, в залежності від розміру поля.

2.27 Version

property Version: string read GetVersion write SetVersion stored false

Використовуйте властивість версії для визначення версії TDbf компонент.

2.28 BeforeAutoCreate

property BeforeAutoCreate: TBeforeAutoCreateEvent read FbeforeAutoCreate

write FBeforeAutoCreate;

Коли таблиця відсутня, а властивість встановлено в OpenMode omAutoCreate і викликаний метод відкритим, то порушується ця подія. Реалізуйте обробник BeforeAutoCreate для запобігання створення таблиці.

2.29 OnCompareRecord

property OnCompareRecord: TNotifyEvent read FOnCompareRecord

write FOnCompareRecord;

Дана подія не використовується.

2.30 OnLanguageWarning

property OnLanguageWarning: TLanguageWarningEvent read FOnLanguageWarning

write FOnLanguageWarning;

Напишіть обробник OnLanguageWarning для заборони дій, коли дані записуються в таблицю зі специфічною кодовою таблицею, а операційна система не в змозі перетворити дані для перегляду в кодову сторінку ANSI. Ви можете вказати режим тільки читанні або редагувати ні на що не дивлячись.

2.31 OnLocaleError

property OnLocaleError: TDbfLocaleErrorEvent read FOnLocaleError

write FOnLocaleError;

Напишіть обробник OnLocaleError для заборони дій, коли індексні дані записані в певному порядку, а операційна система не підтримує цей порядок сортування. Ви можете читати або змінювати індекс ні на що не дивлячись, але індекс може виявитися пошкодженим якщо Ви не розумієте, що робите.

2.32 OnIndexMissing

property OnIndexMissing: TDbfIndexMissingEvent read FOnIndexMissing

write FOnIndexMissing;

Напишіть обробник OnIndexMissing для заборони дій, коли таблиця посилається на конкретний індекс, але індекс відсутній. Значення за замовчуванням це видалити зв'язок.

2.33 OnCopyDateTimeAsString

property OnCopyDateTimeAsString: TConvertFieldEvent

read FOnCopyDateTimeAsString write FOnCopyDateTimeAsString;

Напишіть обробник OnCopyDateTimeAsString для надання свого форматування полів DateTime в рядкові поля. Див також процедуру CopyFrom.

2.34 OnTranslate

property OnTranslate: TTranslateEvent read FOnTranslate write FOnTranslate;

Напишіть обробник OnTranslate для надання користувача перетворення даних таблиці в кодову таблицю "ANSI".

Страницы: 1, 2, 3