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



Компонент TSession

TObject—>TPersistent->TConiponent->TSession Модуль DB

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

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

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

(Rc/f 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

 
« Предыдущая статья   Следующая статья »