抄的。hehe.
---- 由 于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 ADbfTabledo
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 DbfTabledo
begin
{如果数据集处于非活动状态,则执行失败 }
if not active then
exit;
{使数据集的当前记录与 实际的当前记录的位置一致 }
UpdateCursorPos;
{恢复被软删除的记录 }
if DBIERR_NONE < > DbiUndeleteRecord( Handle ) then
exit;{发生错误,操作失败 }
result := true;
{操作成功 }
end;
end;