在Delphi 程序中维护DBF 数据库 (2001年4月8日)
网友更新 分类:数据库 作者: winfit(推荐) 推荐:winfit 阅读次数:269
(http://www.codesky.net)
--------------------------------------------------------------------------------
由 于Delphi 开 发 的 易 用 性 和 快 速 性， 很 多 原 来 使 用Foxpro 和Visual Foxpro 编 程 的 程 序 员 转 向 了Delphi ． 但 由 于 工 作 上 或 其 它 的 原 因， 原 来 的 应 用 系 统 尤 其 是 应 用 数 据， 不 可 能 被 一 下 丢 弃， 因 而 需 要 用Delphi 来 维 护xBase 数 据 库 的 应 用 系 统 ． 本 文 总 结 了 在 工 作 和 学 习 中 的 经 验， 与 广 大Delphi 程 序 员 和 爱 好 者 共 享 ．
在 下 面 讨 论 中， 主 要 应 用 了BDE 的 函 数 ．Delphi1.0 没 有 提 供BDE 函 数 的 帮 助 文 件， 请 参 见 Delphi\Doc 中 的DbiTypes.int、DbiProcs.int 和DbiErrs.int 三 个 文 件； 在Delphi3.0/4.0 中 可 参 见BDE 帮 助 文 件 ． 本 文 讨 论 的DBF 数 据 库 操 作 主 要 有： 真 正 删 除 记 录、 显 示 被 删 除 记 录、 获 取 当 前 记 录 号、 设 置 查 询 匹 配 方 式、 恢 复 被 删 除 记 录 ．
一 ．真正删除记录
在Delphi 程序中，用TTable 或TQuery 构件的方法Delete执行删除记录的操作时执行的是软删除， 即 相 当 于Foxpro 中 的"Set Delete Off" 的 效 果， 仅 将 记 录 用 星 号"*" 标 记 为 删 除， 实 际 并 没 有 数 据 库 中 进 行 物 理 上 的 删 除 ． 要 进 行 真 正 的 删 除， 需 要 进 行Pack Table 的 操 作 ．
在Delphi 程 序 中 真 正 删 除 记 录， 需 要 调 用BDE 函 数， 函 数 名 为DbiPackTable， 函 数 原 型 为：
function DbiPackTable ( hDb : hDBIDb;hCursor : hDBICur; pszTableName : PChar;pszDriverType : PChar; bRegenIdxs : Bool ): DBIResult;
其 中,hDb 为 数 据 库TDatabse 的 句 柄，
hCursor 为 数 据 表TTable 的 句 柄，
pszTableName 为 要 删 除 记 录 的 数 据 表 的 名 称，
pszDriverType 为 要 删 除 记 录 的 数 据 表 的 类 型，
bRegenIdxs 表 示 是 否 在 删 除 记 录 后 自 动 更 新 索 引 文 件 ．
在 上 面 前 四 个 参 数 中，hDb 不 能 为NULL ．hCursor、pszTableName、pszDriverType 可 以 为 NULL， 但 必 须 提 供 足 够 的 信 息 来 标 识 数 据 表 的 文 件 名 称 和 类 型， 当hCursor 不 为 空 时， pszTableName 和pszDriverType 可 以 为NULL； 当pszTableName 为 数 据 表 的 路 径 和 文 件 名 时，hCursor 和pszDriverType 可 以 为NULL ．
值 得 注 意 的 是， 在 删 除 记 录 时， 如 果 用Table 来 实 现， 则Table 必 须 以Exclusive=True 的 方 式 打 开 ． 下 面 就 是 一 个 典 型 的 例 子 ．
首先，应在uses语句加上DbiTypes,DbiProcs,DbiErrs.{ Pack一个DBF数据表,DbfTable包含了数据表的信息 }
function PackDbfTable( DbfTable : TTable ) : boolean;
var
errResult : DBIResult;
begin
if not DbfTable.Exclusive then {如果不是以独占方式,操作失败 }
begin
result := false;
exit;
end;
{进行删除操作 }
errResult := DbiPackTable( DbfTable.dbHandle, DbfTable.handle, NIL, NIL, true );
{根据返回结果,返回成功与否的标志 }
if errResult = DBIERR_NONE then {没有错误,操作成功 }
result := true
else{没有错误,操作失败 }
result := false;
end;
二 ．显示或不显示被软删除记录
当DBF 数 据 库 中 的 记 录 被 软 删 除 后， 缺 省 情 况 下 在TDBGrid 等 数 据 库 构 件 中 是 看 不 见 这 些 记 录 的 ． 我 们 可 以 用BDE 函 数 来 控 制 是 否 显 示DBF 数 据 库 中 被 软 删 除 的 记 录， 就 象 在Foxpro 中 利 用 语 句 Set Delete ON/OFF 那 样 ．
要 用 到 的 函 数 名 为DbiSetProp， 函 数 原 型 为
function DbiSetProp ( hObj : hDBIObj; iProp : Longint; iPropValue : Longint): DBIResult;
该 函 数 用 来 设 置DBI 对 象 中 某 个 属 性 的 值.
其 中,hObj 为DBI 对 象 名 称， 我 们 这 里 为 数 据 表TTable 的 句 柄；
iProp 为 属 性 名 称， 我 们 用 的 是 软 删 除 属 性curSOFTDELETEON；
iPropValue 为 属 性 值， 我 们 用True 或False 表 示 是 否 使 软 删 除 的 记 录 被 显 示 ．
下 面 就 是 一 个 典 型 的 例 子 ．
同 样， 应 在uses 语 句 加 上DbiTypes,DbiProcs,DbiErrs.
{显示DBF数据表中的软删除记录,DbfTable包含了数据表的信息,DeleteOn 表示是否显示,True表示显示 }
function SetDbfDelete( DbfTable : TTable ; DeleteOn : boolean ) : boolean;
var
errResult : DBIResult;
begin
result := false; {操作失败时,返回False }
{如果数据表没有打开,则操作失败 }
if ( not DbfTable.active ) then
exit;
{进行设置显示操作 }
errResult := DbiSetProp( hDBIObj(DbfTable.Handle), curSOFTDELETEON,LongInt( DeleteOn ));
if errResult = DBIERR_NONE then {没有错误,则操作成功 }
begin
result := true;
DbfTable.refresh;
end;
end;
三．获取当前记录号
在 用Foxpro 时,RecNo() 函 数 用 惯 了， 在Delphi 程 序 没 有 这 样 的 函 数 觉 得 别 扭 ． 下 面 我 们 可 以 用BDE 函 数 获 取 当 前 记 录 在 数 据 集 中 的 记 录 号 ．
要 用 到 的 函 数 名 为DbiGetRecord， 函 数 原 型 为
function DbiGetRecord (hCursor : hDBICur; eLock : DBILockType; pRecBuff : Pointer;precProps : pRECProps ): DBIResult;
该 函 数 用 来 取 得 当 前 记 录 的 一 些 属 性 ．
其 中，hCursor 可 为 数 据 集 的Handle，
eLock 为 对 记 录 加 锁 的 类 型，
pRecBuff 存 放 记 录 的 缓 冲 区，
precProps 为 记 录 属 性 集 ．
下 面 就 是 一 个 典 型 的 例 子 ．
同样，应在uses语句加上 DbiTypes,DbiProcs,DbiErrs.
{取得当前记录的记录号 }
function RecNo( ADbfTable : TTable ) : LongInt;
var
RecordProps: RecProps;
begin
Result := 0; {返回0表示函数执行失败 }
with ADbfTable do
begin {如果数据集处于非活动状态,则执行失败 }
if not active then
exit;
{使数据集的当前记录与实际的当前记录的位置一致 }
UpdateCursorPos;
{取得当前记录的属性, 主要是记录的位置 }
if DBIERR_NONE < > DbiGetRecord (Handle, dbiNOLOCK, nil, @RecordProps) then
exit;{发生错误,则操作失败 }
Result := RecordProps.iPhyRecNum; {取得记录号 }
end;
end;
四．设置查询匹配方式( 精确匹配/ 非精确匹配)
在 用Foxpro 时，Set Exact ON/OFF 对 数 据 查 询 影 响 很 大 ． 在Delphi 中， 我 们 同 样 可 以 进 行 这 样 的 设 置 ．
要 用 到 的 函 数 名 为DbiSetProp， 这 次 用 的 属 性 名 称iProp 为curINEXACTON， 属 性 值iPropValue 为 True 或False，True 表 示Set Exact OFF ．
下 面 就 是 一 个 典 型 的 例 子 ．
同样，应在uses语句加上DbiTypes,DbiProcs,DbiErrs.
{设置匹配方式，DbfTable 包含了数据表的信息,ExactOn 表示是否精确匹配,True表示是 }
function SetDbfExact( DbfTable : TTable ; ExactOn : boolean ) : boolean;
var
errResult : DBIResult;
begin
{如果没有打开,则操作失败 }
if ( not DbfTable.active ) then
begin
result := false;
exit;
end;
{进行设置显示操作 }
errResult := DbiSetProp( hDBIObj(DbfTable.Handle), curINEXACTON, LongInt( not ExactOn ));
if errResult = DBIERR_NONE then {没有错误,操作成功 }
result := true
else{发生错误,操作失败 }
result := false;
end;
五．恢复被软删除的记录
在Delphi 应 用 程 序 中， 对DBF 数 据 表 执 行 的 删 除 操 作 为 软 删 除 操 作 ． 由 于 物 理 记 录 并 没 有 从 数 据 表 中 删 除， 我 们 就 可 以 恢 复 被 软 删 除 的 记 录， 只 要 去 掉 删 除 标 志 即 可 ．
要 用 到 的 函 数 名 为DbiUndeleteRecord， 函 数 原 型 为：
function DbiUndeleteRecord ( hCursor : hDBICur ): DBIResult;
其 中，hCursor 可 为 数 据 集 的Handle ．
下 面 就 是 一 个 典 型 的 例 子 ．
同样，应在uses语句加上DbiTypes,DbiProcs,DbiErrs.
{恢复被软删除的记录 }
function UndeleteRecord( DbfTable : TTable ) : boolean;
begin
Result := false;
{返回false表示函数执行失败 }
with DbfTable do
begin
{如果数据集处于非活动状态,则执行失败 }
if not active then
exit;
{使数据集的当前记录与 实际的当前记录的位置一致 }
UpdateCursorPos;
{恢复被软删除的记录 }
if DBIERR_NONE < > DbiUndeleteRecord( Handle ) then
exit;{发生错误,操作失败 }
result := true; {操作成功 }
end;
