Розробка мережевої бібліотеки засобами середовища Delphi

(Rd) property DatabaseCount: Integer;

Визначає число екземплярів компонента TDatabase, використовуваних у додатку в даний час.

(Rd property Databases[Index: Integer]: TDatabase;

Містить список всіх екземплярів компоненту TDatabase, що використовуэться програмою в даний час.

(Ro) property Handle: HDBISES; property KespConnections: Boolean;

Дескриптор компонента, використовується для організації прямого доступу до функцій API BDE.

Визначається режим з'єднання з базою даних. В значенні True з'єднання буде підтримуватися до завершення додатку або виклику методу DropConnection. В значенні False з'єднання переривається зразу ж після закриття всіх наборів даних відкритою бази.

(Ro) property Locale: TLocale; TLocale = Pointer;

Містить інформацію про мовний драйвер BDE.

property NetFileDir: String;

Визначає каталог, що містить мережний файл керування BDE -- PDOXUSRS.NET, призначений для з'єднання з таблицями Paradox.

property PrivateDir: String;

Визначає каталог, що зберігає тимчасові файли.

procedure AddPassword(const Password: String);

Дозволяє задати пароль для доступу до таблиць Paradox.

procedure CloseDatabase(Database: TDatabase) ;

Закриває компонент TDatabase, ідентифікований по параметрі Database.

procedure DropConnections;

Перериває всі з'єднання з неактивними базами даних (не мають відкритих додатком наборів даних).

function FindDatabase(const DatabaseName: String): TDatabase;

Проводить пошук компонента бази даних у списку властивості Databases по імені, що задається параметром методу. Повертає покажчик на екземпляр компонента TDatabase.

procedure GetAliasNames(List: TStrings);

Очищає список, переданий у параметрі List методу і заповнює його іменами усіх визначених у BDE псевдонімів.

procedure GetAliasParams(const AliasName: String; List: TStrings);

Очищає і заповнює список List параметрами псевдоніма, що задається параметром AliasName.

procedure GetDatabaseNames(List: TStrings) ;

Повертає список List імен усіх баз даних, визначених у BDE і додатку.

procedure GetDriverNames(List: TStrings) ;

Очищає і заповнює список List, переданий параметром методу, іменами усіх встановлених у BDE драйверів.

procedure GetDriverParams(const DriverName: String; List: TStrings) ;

Очищає і заповнює список параметрами драйвера BDE. Параметр DriverName задає ім'я драйвера, параметр List визначає список.

function GetPassword: Boolean;

Показує стандартний діалог уведення пароля. Повертає True при натисканні кнопки ОК і False при натисканні

Cancel.

procedure GetTableNames(const DatabaseName, Pattern: String; Extensions, SystemTables: Boolean; List: TStrings) ;

Очищає список List і заповнює його іменами всіх таблиць бази даних, ім'я якої визначається параметром DatabaseName. Параметр Pattern задає шаблон добору імен таблиць. Параметр Extensions у стані True дозволяє додавати до імен таблиць розширення файлів. Параметр SystemTables у стані True дозволяє додавати до списку системні таблиці серверів SQL.

procedure GetStoredProcNames(const TStrings) ;

Заповнює список List іменами всіх збережених процедур для SQL-сервера, що задається параметром DatabaseName.

function OpenDatabase(const DatabaseName: String): TDatabase;

Відкриває існуючий компонент TDatabase чи створює новий, використовуючи параметр методу DatabaseName. Повертає покажчик на екземпляр компонента.

Знищує всю раніше введену інформацію про паролі для Paradox.

procedure RemovePasswordfconst Password: String);

Видаляє пароль, обумовлений параметром Password методу для таблиць Paradox.

(Pb) property AliasName: TSymbolStr; TSymbolStr = String[DBIMAXNAMELEN] ; DBIMAXNAMELEN = 31;

Ім'я псевдоніма, заданого утилітою конфігурації BDE. Значення цієї властивості занулюється при установці властивості DriverName. Використовується для зв'язування з визначеним сервером.

ipb) property Connected: Boolean;

Керує процесом з'єднання компонента з базою даних. У стані True дозволяє з'єднання і відкриття таблиць. Працює спільно з властивістю Keep Connection.

(Pb) property DatabaseName: TFileName; TFileName: String[79];

Задає псевдонім бази даних, що приєднується, для додатка, що може використовуватися компонентами наборів даних (TTable, TQuery) і відображається в їхній властивості DatabaseName.

(Ro) property DatasetCount: Integer;

Відбиває число компонентів наборів даних, використовуваних невізуальним компонентом TDatabase.

(Ro) property Datasets[Index: Integer]: TDBDataset;

Масив покажчиків на екземпляри компонентів приєднаних наборів даних.

(Pb) property DriverName: TSymbolStr;

Ім'я використовуваного додатком драйвера BDE. Це властивість занулюється при визначенні властивості AliasName.

(ro) property Handle: HDBIDB;

Показник на базу даних, використовується для прямого виклику функції API BDE.

(Ro) property IsSQLBased: Boolean;

Відбиває тип використовуваного драйвера, залежить від властивості DriverName. Стан True дозволяє використання будь-якого драйвера, крім STANDARD.

(Pb) property KeepConnection: Boolean;

У значенні True задає постійне з'єднання з базою даних навіть при відсутності відкритих наборів даних. При виключеній властивості для реєстрації на сервері необхідно користатися властивістю Connected для кожного відкриття таблиці.

(Ro) property Locale: TLocale;

Визначає використовуваний компонентом драйвер. Дозволяє здійснювати прямий доступ до API BDE.

(Pb) property LoginPrompt: Boolean;

У стандартному значенні True визначає, що при установці з'єднання з базою даних буде з'являтися діалогове вікно реєстрації користувача. У значенні False реєстраційні зведення повинні міститися в полях властивості Params.

(Pb) property Params: TStrings;

Містить параметри, необхідні для підключення до баз даних. За замовчуванням це значення властивості встановлюється у відповідність з інформацією утиліти конфігурації BDE.

property Temporary: Boolean;

(Pb) property Translsolation: TTransIeolation;

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

Визначає рівень ізоляції транзакції і використовується SQL-сервером. Значення tiDirtyRead дозволяє транзакції читати незавершені зміни, проведені іншою транзакцією; tiReadCommit відкриває доступ до змін після завершення транзакції; tiRepeatableRead цілком ізолює транзакцію.

procedure Close;

Від'єднує всі зв'язані з ним компоненти TTable TQuery і TStoredProc.

procedure CloseDatasets;

Від'єднує всі дочірні компоненти класу TDataSet, але сам компонент залишається відкритим.

procedure Commit;

Фіксує всі зміни, проведені транзакцією. Цей метод можна використовувати тільки при наявності зв'язку з базою даних.

procedure Open;

З'єднує компонент із чи сервером BDE у випадку використання СУБД Paradox чи dBase.

procedure Rollback;

Скасовує всі дії, зроблені транзакцією, тобто забороняє її фіксацію.

procedure StartTransaction;

Починає виконання транзакції, використовуючи рівень ізоляції з властивості Translsolation. Цей метод рекомендується використовувати тільки при наявності зв'язку з базою даних.

(Pb) property AutoEdit: Boolean;

Чи дозволяє забороняє зміна даних візуальними компонентами, зв'язаними з TDataSource. У визначеному стані -- True, запис дозволений.

(Рb) property Dataset: TDataSet;

Визначає зв'язані компоненти TTable, TQuery і TStoredProc.

(Pb) property Enabled: Boolean;

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

(Ro) property State: TDataSetState;

Задає поточний стан для зв'язаного компонента набору даних. Це властивість повинна бути встановлена у відповідність із властивістю State зв'язаного компонента набору даних. Можливі значення: dsBrowse, dsCalcField, dsEdit, dslnactive, dslnsert, dsSetKey. При властивості Enabled у значенні False чи не визначеному значенні властивості Dataset властивість State повинна встановлюватися в значення dslnactive. Докладно можливі стани описуються наприкінці роздягнула.

(Pb) property Active: Boolean;

(Pb) property AutoCalcField: Boolean;

Регулює доступ до даних. При значенні True відкриває набір даних і встановлює його в стан Browse, у противному випадку встановлюється стан Inactive.

Визначає виклик оброблювача події OnCalcField. У значенні True метод викликається завжди при редагуванні полів.

(Ro) property BOF: Boolean; (Ro) property CanModify: Boolean;

Повідомляє про перебування курсору в першому записі набору даних.

Встановлює можливість редагування.

(Ro) property Database: TDatabase;

Ідентифікує компонент TDatabase, зв'язаний з TTable.

(Pb) property DatabaseName: TFil-Name;

Визначає доступ до бази даних. Може задаватися у виді псевдоніма BDE, шляху до файлів, специфічного псевдоніма додатка.

(Ro) property DBHandle: HDBIDB; (Ro) property DBLocale: TLocale;

Визначає дескриптор бази даних, необхідний, зокрема, для організації виклику функцій API BDE з додатку.

Задає драйвер для BDE.

(Bg) property EOF: Boolean;

Інформує про знаходження курсору в останній записі набору даних.

(Pb) property Exclusive: Boolean;

(Pо) property FieldCount: Integer;

Використовується для установки повного контролю над таблицею, що відкривається, і запобігання доступу до неї інших користувачів. Перед роботою з цією властивістю необхідно задати властивості Active значення False. При спробі відкриття уже використовуваної іншими таблиці з Exclusive = True виникає виняткова ситуація. Властивість корисна при створенні додатків для систем, що використовують поділювані файли.

Повідомляє про число стовпчиків таблиці, використовується візуальними компонентами відображення даних.

Wo) property FieldDefs: TFieldDefs;

Містить інформацію про кожен об'єкт TFieldDef (див. нижче), зв'язаному з компонентом таблиці.

(Ro) property Fields[Index: Integer]: TField;

Дозволяє одержати інформацію про поля таблиці.

(ro) property Handle: HDBICur;

Дескриптор компонента, дозволяє одержати доступ до функцій API BDE.

(Ro) property IndexDefs: TIndexDefs;

Дозволяє одержати інформацію про усіх використовуваних компонентомом індексах. Перед використанням властивості необхідно викликати метод Update об'єкта TIndexDefs для відновлення даних.

(Ro) property IndexFieldCount: Integer;

Означає число дійсних полів для поточного індексу.

(Вd) property IndexFieldNames: String;

Використовується SQL-сервером для ідентифікації полів, що є індексами. Імена полів розділяються крапкою з коми і не повинні містити більш 255 символів. Тут можуть бути описані не тільки фізичні індекси (збережені в індексних файлах), але і створювані на час виконання додатка.

(Pb) property IndexName: String;

Визначає вторинний індекс. Установка властивості приводить до обнуління властивості IndexFieldNames.

(Ro) property IndexFields[Index: Integer] ^Fields-

Містить інформацію про всі поля поточного індексу.

property KeyExclusive: Boolean;

Визначає, чи виключати з розгляду сортування, що повертаються функціями, і пошуку запису. Значення за замовчуванням -- False. Для методів SetRangeStart і SetRangeEnd визначає що включають чи виключають границі діапазону значень. Для методів GoToNearest і FindNearest визначає місце перебування курсору.

property KeyFieldCount: Integer;

Визначає число ключових полів для

пошуку.

(Ro) property Locale: TLocale;

Ідентифікатор мовного драйвера для BDE.

(Pb) property MasterFields: String; TDataSource;

(Ro) property Modified: Boolean;

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

Визначає компонент TDataSource, що представляє головну таблицю.

Показує чи проводились зміни в полях запису з моменту відкриття таблиці або виклиці методів Post або Cancel.

(№;) property Readonly: Boolean;

Встановлює режим "Тільки для читання". Перед використанням необхідно встановити властивість Active у False.

(Ro) property RecordCount: Longint;

Відображає число записів у наборі даних.

(Ro) property State: TDataSetSCate; (Pb) property TableName: TFileName;

Показує поточний стан набору даних (див. аналогічна властивість компонента TDataSource). Значення цієї властивості важлива при використанні багатьох методів компоненту.

Містить ім'я таблиці, використовуваної компонентом.

(Pb) property TableType: TTableType;

Визначає тип використовуваної таблиці відповідно до розширення файлу (режим Default) чи типом TTableType, що містить наступні значення: ttDefault, "Paradox, "DBase, "ASCII.

(Pb) property UpdateMode: TUpdateMode;

Визначає спосіб відновлення даних при роботі з базами SQL і задає полючи, що використовуються для пошуку запису в базі. Можливі наступні значення: Where All -- використовує всі полючи; WhereKeyOnly -- використовує тільки ключові полючи; WhereChanged -- використовує ключові і змінені полючи запису. Найбільш твердим, кращим і надійної є режим WhereAll (установлюється за замовчуванням).

(РB) property OnCalcFields: TDataSetNotifyEvent ; TDataSetNotifyEvent = procedure (DataSet: TDataSet) of object;

Використовується для визначення значень полів, що обчислюються, і викликається при читанні запису з бази. При властивості AutoCalcFields = True цей оброблювач викликається при зміні значень полів, що необчислюються, якщо встановлений стан EdsEdit чи Edslnsert. При виконанні процедури набір даних повинний знаходитися в стані CalcFields.

(РB) property OnNewRecord: TDataSetNotifyEvent;

Реагує на додавання в набір даних нового запису. Дозволяє редагувати нові записи без зміни властивості Modified,

procedure Addlndex(const Name, Fields: String; Options: TIndexOptions); TIndexOptions = set of (ixPrimary, ixUnique, ixDescending, ixNonMaintained, ixCaseInsensitive);

Створює новий індекс для компонента. Параметри: Name -- назва індексу, Fields -- полючи індексу, Options -- опції типу TindexOptions.

procedure ApplyRange;

Проводить фільтрацію записів таблиці. Підмножина добору визначається методами SetRangeStart і SetRangeEnd чи EditRangeStart і EditRangeEnd.

procedure Append;

Призначена для включення в таблицю нових записів. Метод позиціонує курсор у кінець набору, переводить його в стан Insert і відкриває новий порожній запис.

procedure AppendRecord(const Values: array of const) ;

Додає до таблиці новий непорожній запис, дані для полів визначаються параметром Values. Порядок проходження зберігається. Якщо число елементів параметра менше числа полів, то що залишилися полючи встановлюються в NULL. Типи елементів параметра Values повинні збігатися з типами полів.

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

Додає, видаляє, чи копіює обновляє групи записів. Параметри: ASource задає джерело запису, AMode -- використовуваний режим. Режим визначається типом TBatchMode: batAppend, batUpdate, batAppendUpdate, batDelete, batCopy. Функція повертає число оброблених записів.

procedure Cancel;

Переводить набір даних у стан dsBrowse і скасовує будь-які зміни для поточної запису.

procedure CancelRange;

Скасовує фільтрацію записів таблиці, що задається функціями ApplyRange і SetRange.

procedure CheckBrowseMode;

Робить перевірку відкриття набору даних і відсутності передбачуваних змін. Якщо набір даних закритий, виводиться відповідне повідомлення про помилку. Якщо компонент знаходиться в стані dsEdit, dslnsert чи dsSetKey, то викликається метод Post для передачі в базу даних будь-яких накопичених змін.

procedure ClearFields;

Повертає всім полям поточного запису вихідні значення. Набір даних повинний знаходитися в стані dsEdit.

Закриває набір даних. Аналогічна установці властивості Active у False.

procedure CreateTable; procedure CursorPosChanged;

procedure Delete;

procedure String) ;

Створює нову порожню таблицю. Перед викликом методу необхідно установити необхідні значення властивостей DatabaseName, TableName, TableType, FieldDefs і IndexDefs.

Використовується для передачі повідомлення компоненту TDataSet про зміну положення курсору функціями API BDE. Ця процедура використовується при визначеній властивості Handle.

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

Видаляє вторинний індекс. Параметр Name -- назва індексу. Для використання методу необхідно установити властивість Exclusive у True.

procedure DeleteTable;

Знищує таблицю, обумовлену властивостями DatabaseName, TableName, TableType.

procedure DisableControls;

Тимчасово припиняє з'єднання набору даних із усіма зв'язаними компонентами TDataSource. У результаті переривається зв'язок з візуальними компонентами. Існує метод зворотної дії -- EnableControls.

Установлює властивість State у dsEdit і підготовляє поточну запис до модифікації.

procedure EditKey;

Призначена для коректування вмісту буфера ключів пошуку. Використовується тільки для .пошуку на багатьох полях після виклику методу SetKey. Для переміщення в знайдене поле використовується метод GotoKey. He очищає буфер ключів пошуку після використання.

procedure EditRangeEnd;

Дозволяє перевизначити порядок добору записів, установлений методом SetRangeEnd. Модифікується набір ключів кінця послідовності. Новий порядок може бути реалізований методом ApplyRange. Для таблиць Paradox і dBase метод застосуємо тільки для індексованих полів, а для баз SQL -- для всіх стовпчиків, визначених властивістю IndexFieldNames.

procedure EditRangeStart;

Діє аналогічно попередньому методу, змінюючи значення початкового ключа.

procedure EmptyTable;

Знищує всі записи таблиці, що визначається властивостями DatabaseName, TableName і TableType. Для відкритої таблиці повинне бути включена властивість Exclusive.

procedure EnableControls;

Відновлює з'єднання з усіма компонентами TDataSource, зв'язаними з даним компонентом і тимчасово відключеними методом DisableControls.

function FieldByName(const FieldName: String): TField;

Повертає посилання на екземпляр об'єкта TField і зручна для роботи з конкретним полем. Її використання не порушує структури таблиці, на відміну від застосування властивості Fields. Параметром FieldName передається назва полючи.

function FindField(const FieldName: String): TField;

Повертає посилання на екземпляр об'єкта TField, використовуючи ім'я, передане параметром PieldName. Не змінює структуру таблиці. У випадку відсутності заданого полючи повертає nil.

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

Призначений для пошуку запису по індексі. Параметр KeyValues задає список полів індексу. Метод установлює набір даних у стан SetKey. У випадку успіху функція повертає True і переміщає курсор на знайдений запис, у випадку невдачі повертається False.

procedure FindNearest(const KeyValues: array of const);

Знаходить запис, індекс якого чи більше дорівнює заданому параметром KeyValues. Курсор переміщається на знайдений запис. Для пошуку можуть використовуватися тільки строкові полючи. За замовчуванням використовуються первинні індекси, завдання необхідних значень властивостей IndexFieldNames чи IndexName дозволяє проводити пошук по інших індексах. Для таблиць Paradox і dBase метод застосуємо тільки до індексованих полів, а для баз SQL -- до всіх полів, визначеним властивістю IndexFieldNames.

procedure First;

Установлює курсор на перший запис поточного розташування записів набору даних. На результат впливає застосування методу SetRangeStart.

procedure FreeBookmark(Bookmark: TBookmark) ; TBookmark = Pointer;

Звільняє системні ресурси, використовувані методом GetBookmark. Параметр Bookmark задає ідентифікатор використовуваної закладки.

function GetBookmark: TBookmark;

Установлює закладку на поточній записі, до неї можна повернутися в будь-який момент за допомогою методу GotoBookmark. Повертає покажчик на екземпляр закладки типу TBookmark. Усі встановлені закладки знищуються при закритті чи таблиці зміні індексів.

procedure GetFieldNames(List TStrings) ;

procedure GetIndexNames(List TStrings) ;

procedure GotoBookmark(Bookmark: TBookmark) ;

: Записує імена полів набору даних у параметр List.

Записує всі індекси набору даних у параметр List.

Позиціонує курсор на записі, який відповідає закладка, покажчик на який передається в параметрі Bookmark.

procedure GotoCurrent(Table: TTable);

Використовується для сполучення курсорів двох екземплярів компонента, що використовують ту саму таблицю. Змінюється положення курсору того компонента, що заданий параметром Table. Для виконання методу необхідна ідентичність властивостей DatabaseName і TableName обох екземплярів компонента.

function GotoKey: Boolean;

Переміщає курсор на запис, обумовлений ключем. Повертає True у випадку успішного пошуку. Використовується разом з методами SetKey чи EditKey. Якщо для ключа використовується кілька полів, то їхнє число необхідно задати властивістю KeyFieldCount.

procedure GotoNearest

Переміщає курсор на останній запис текучого порядку розположення записів. На результат впливає використання методу SetRangeEnd.Використовується для переходу до запису, чий індекс дорівнює або більше значення властивості IndexField. Пошук проводиться з першого запису. Використовується разом з методами SetKey і EditKey.

procedure Insert;

Переводить набір даних у стан Insert і вставляє на місці курсору новий порожній запис. При наявності в таблиці індексів метод розміщає новий запис у відповідність з ними.

procedure InsertRecordfconst Values: array of constIt

Додає в набір даних новий запис, заповнюючи її полючи значеннями, переданими параметром Values. Число величин у параметрі може бути менше, ніж полів у таблиці, у цьому випадку відсутні значення будуть інтерпретуватися як порожні. Типи даних повинні збігатися. При наявності в таблиці індексів метод розміщає новий запис у відповідність з ними.

Опції

ixCaseInsensitive

Paradox

+

DBase

-

ixDescending

+

+

IxNonMaintained

+

+

IxPrimary

+

IxUnique

+