点击或拖拽改变大小

Functions.DbUseArea 方法

X#
打开一个数据库文件。

命名空间:  XSharp.RT
程序集:  XSharp.RT (在 XSharp.RT.dll 中) 版本:2.22 GA
语法
 FUNCTION DbUseArea(
	lNewArea,
	cDriver,
	cDataFile,
	cAlias,
	lShared,
	lReadOnly,
	aStruct,
	cDelim,
	acRDDs
) AS LOGIC CLIPPER
查看代码

参数

lNewArea (Optional)
类型:__Usual
指定是否在新的工作区中打开文件。TRUE 选择最低编号的未占用工作区作为使用操作前的当前工作区。
如果 lNewArea 为 FALSE 或省略,则使用当前工作区(如果工作区已被占用,则先关闭)。
cDriver (Optional)
类型:__Usual
将为工作区提供服务的 RDD 的名称。
如果未指定,则使用由 RDDSetDefault() 确定的默认 RDD。
cDataFile (Optional)
类型:__Usual
要打开的数据库文件的名称,包括可选的驱动器、目录和扩展名。
如果数据库文件有对应的备注文件,也会被打开。
数据库和备注文件的默认扩展名由 RDD 确定。
如果数据库文件或其对应的备注文件不存在,将引发运行时错误。有关文件搜索和创建规则,请参阅 SetDefault() 和 SetPath()。
cAlias (Optional)
类型:__Usual
当打开 cDataFile 时与工作区关联的标识符名称。
如果未指定,别名默认为数据库文件名。在单个应用程序中不允许重复的别名名称。
lShared (Optional)
类型:__Usual
TRUE 尝试以共享模式打开 cDataFile。FALSE 尝试以独占(非共享)模式打开 xcDataFile,拒绝所有其他进程访问,直到数据库文件关闭。如果省略 lShared,当前的 SetExclusive() 设置决定是否允许共享访问。然而,强烈建议您在 USE 命令中指定打开模式,而不是依赖 SetExclusive() 来确定。
lReadOnly (Optional)
类型:__Usual
TRUE 尝试以只读属性打开 cDataFile,禁止对工作区进行更新。FALSE 尝试以读写属性打开 cDataFile,允许更新。
如果省略 lReadOnly,默认值为 FALSE。
如果无法使用指定的属性访问 cDataFile,将引发运行时错误。
aStruct (Optional)
类型:__Usual
包含字段描述的数组,格式与 DBStruct() 返回的格式相同。
此参数不适用于 DBF 文件。
它旨在用于不存储字段描述的文件格式。
例如,如果您使用支持 SDF 或分隔文件的 RDD,可以使用此参数定义文件结构,然后可以与其他命令或函数一起使用来访问字段描述。以下是此参数的示例:
X#
1{"First", "C", 35, 0};<br />
2
3{"Last", "C", 35, 0};<br />
4
5{"Birthday", "D", 8, 0}}<br />
6
7? First                    // 返回: Josie
cDelim (Optional)
类型:__Usual
分隔数据库文件中字段的分隔符。
如果您使用提供的 RDD 之一来处理 .DBF 文件,分隔符应为 NULL_STRING,这是省略参数时的默认值。
acRDDs (Optional)
类型:__Usual
一个包含 RDD 名称的一维数组,主 RDD 从中继承特殊功能。
这允许您在具有不同数据库驱动程序的不同工作区中使用具有特殊功能的 RDD,例如加密或解密。
这些 RDD 覆盖主 RDD 的特殊功能(使用 cDriver 参数指定)。
如果多个 RDD(使用此参数指定)实现相同的功能,则列表中最后一个 RDD 关联的功能优先。
如果省略 acRDDs,则不假定有其他 RDD。

返回值

类型:Boolean
如果成功则返回 TRUE;否则返回 FALSE。
备注
DBUseArea() 是 USE 命令的功能等效项。
有关更多信息,请参阅 USE 命令。
示例
这个例子是 DBUseArea() 函数的典型用法:
X#
1DBUseArea(TRUE, "DBFMDX", "employees")
参见