数据工作期管理器(Data Session Manager)

请参阅

种类 Application
默认目录 Visual FoxPro Catalog\Foundation Classes\Application
_datasession
基类 Custom
类库 _app.vcx
父类 _custom
示例 ...\Samples\Vfp98\Solution\Ffc\environ.scx

说明

该类用于管理数据工作期,并管理当前数据工作期中所有表单或表单集的数据更新。该类使一个 Application 对象,简便地在各工作期间进行重复,以便在 Exit 或 Shutdown 过程中提供 Windows 的关闭操作。该类也为表单和表单集提供了一般的 QueryUnload 操作、以及一般工作期范围内的 Update 和 Revert 代码。对于数据工作期,在使用自己的冲突处理过程之前,可以使用该类判断数据是否已更改。

本类可以用于自由表,也可以用于数据库中的表。符合事务限制 。

使用该类的方法是:将其拖放到一个项目或表单中,或者从“组件管理库”的“数据项”快捷菜单中选择“添加至项目”或“添加至表单”命令。将该类添加到表单时,Visual FoxPro 将该类放在表单上。然后可指定合适的属性值,并提供必要的输入和输出对象。在将该类拖放到项目时,可以选择添加该类或创建一个子类。

有关使用基本类的详细内容,请参阅“Visual FoxPro 基本类的使用指南”

属性、事件、方法程序 说明
iDataChangedMode 属性 指定数据更改的类型。

0 – 一切都已更改。
1 – 忽略位于 Updatefields 列表以外的视图字段。
2 - 忽略没有设置为“发送更新”的视图。

默认值:0

iSavedSessionID 属性 指定表示已保存的工作期的整数值。
默认值:1
lSuccess 属性 指定数据操作(更新)是否成功。
默认值:.T.
lUseTransactions 属性 指定是否将更新例程包装在一个事务中。

注意 在事务处理过程中只有数据库容器(.dbc)中的表受影响。

默认值:.T.

DataChanged 方法程序 检查数据是否已更改。
语法:DataChanged( )
返回值:
参数:
DataFlush 方法程序 当表格获得焦点时,即使选择从工具栏按钮更新数据,本方法程序也将确保活动控件能使自己当前的内容“被识别”。
语法:DataFlush( )
返回值:
参数:
GetActiveControlRef 方法程序 在当前活动控件是表格时,返回真正活动的控件 loRealActiveControl
语法:GetActiveControlRef(toActiveControl)
返回值:loRealActiveControl
参数:
toActiveControl 指定当前控件。
GetMessageBoxTitle 方法程序 返回指定消息名称的标题栏的文本部分。
语法:GetMessageBoxTitle( )
返回值:cTitlebarText
参数:
QueryUnload 方法程序 提供对话框用来管理数据的更改决定。
语法:QueryUnload(tlDataChangeAlreadyConfirmed, toForm, tlNoShow)
返回值:liResult
参数:
tlDataChangeAlreadyConfirmed 指定数据是否已更改。
toForm 指定表单。
tlNoShow
指定是否显示该表单。
liResult 指定 MESSAGEBOX 或其值。
RestoreSessionID 方法程序 恢复数据工作期。
语法:RestoreSessionID
返回值:
参数:
Revert 方法程序 将数据工作期恢复至初始数据。
语法:Revert(tlUserChoiceAlreadyConfirmed, tlDataChangeAlreadyConfirmed, toForm, tlNoShow)
返回值:
参数: tlUserChoiceAlreadyConfirmed 指定是否显示一个确认对话框。
tlDataChangeAlreadyConfirmed 指定是否显示一个确认对话框。
toForm 指定表单。
tlNoShow
指定是否显示该表单。
SetSessionID 方法程序 设置数据工作期。
语法:SetSessionID( )
返回值:
参数:
Update 方法程序 更新数据。
语法:Update(tlUserChoiceAlreadyConfirmed, tlDataChangeAlreadyConfirmed, toForm, tlNoShow)
返回值:
参数: tlUserChoiceAlreadyConfirmed 指定是否显示一个确认对话框。
tlDataChangeAlreadyConfirmed 指定是否显示一个确认对话框。
toForm 指定表单。
tlNoShow
指定是否显示该表单。