Происходит в момент, когда база данных становится активной. Имеется две версии синтаксиса.

PROCEDURE dbc_Activate(cDatabaseName) 
PROCEDURE dbc_Activate
LPARAMETERS cDatabaseName

Параметры

cDatabaseName

Указывает имя активируемой базы данных.

Expand imageПримечания

Вы можете иметь несколько открытых в одно и тоже время баз данных, но только одна из них может быть активной в конкретный момент времени. База данных становится активной под влиянием нескольких обстоятельств. Явное активирование базы данных производится с помощью команды SET DATABASE TO. Если открыто несколько баз данных (с разрешенными событиями контейнеров DBC ) метод dbc_Activate испольняется только в активной базе данных.

Если вы поместите код событий контенейров базы данных - DBC - в программный файл, то код будет применяться к любой базе данных, которую укажет программа, как файл процедурных кодов событий. В таком случае, процедурный код методов, ассоциированных с событиями DBC может одновременно воздействовать на несколько баз данных в одно и тоже время. Когда вы используете события DBC указанным методом, используйте параметр cDatabaseName в коде события, указывающий - какую базу данных следует активировать. Таким образом вы можете использовать один блок кода для определения активируемой базы данных и затем соответствующих образом применить его к этой базе данных.

Возврат False (.F.) из процедурного кода события предотвратит активирование базы данных.

Visual FoxPro будет игнорировать возврат False (.F.) из этого события в design time.

Expand imageПример

  CopyCode imageСкопировать код
PROCEDURE dbc_Activate ;
         (cDatabaseName)
? '     cDatabaseName  = ' + TRANSFORM(cDatabaseName) + ' - ' ;
                       + TYPE('cDatabaseName ')+' /end/ '
ENDPROC

Expand imageСмотрите также