Справочник по компонентам Delphi. Часть 3 - Компонент TSession

Written on . Posted in Delphi

ОГЛАВЛЕНИЕ

Страница 20 из 44

Компонент TSession

 TObject -> TPersistent->TConiponent->TSession

Модуль DB

В Палитре компонентов отсутствует

Осуществляет общее управление процессом связывания базы данных с приложением. Он отсутствует в Палитре компонентов Delphi и создается ав­томатически при выполнении приложения, при этом ему присваивается имя Session. Объект обладает рядом методов, которые позволяют получать и использовать информацию о связях с базой данных. Все свойства объекта доступны только при выполнении приложения и в режиме "Только для чтения". Исключение составляют свойства KeepConnections, NetFileDir и PrivateDir, зна­чения которых можно изменять.

Свойства компонента

(property DatabaseCount: Integer;Определяет число экземпляров компонента TDatabase, используемых в приложении в настоящее время.
property Databases[Index: Integer]: TDatabase;Содержит список всех экземпляров компонента TDatabase, использующихся в приложении в настоящее время.
(Ro) property Handle: HDBISES;
Дескриптор компонента, используется для организации прямого доступа к функциям API BDE.
 property KespConnections: Boolean; Определяет режим соединения с базой данных. В значении 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. Возвращает указатель на экземпляр компонента.
procedure RemovePasswordfconst Password: String);Удаляет пароль, определяемый параметром Password метода для таблиц Paradox

форум delphi