点击或拖拽改变大小

Functions.VoDbUseArea 方法 (Boolean, _RddList, String, String, Boolean, Boolean)

X#
打开数据库文件。

命名空间：  XSharp.RT
程序集：  XSharp.RT (在 XSharp.RT.dll 中) 版本：2.22 GA
语法
复制
 FUNCTION VoDbUseArea(
	lNewArea AS LOGIC,
	rddlist AS _RddList,
	cDataFile AS STRING,
	cAlias AS STRING,
	lShared AS LOGIC,
	lReadOnly AS LOGIC
) AS LOGIC
查看代码

参数

lNewArea
类型：Boolean
指定是否在新工作区中打开文件。TRUE 在使用操作之前选择最低编号的未占用工作区作为当前工作区。FALSE 使用当前工作区（如果工作区已被占用，则先关闭它）。
rddlist
类型：_RddList
List of RDDs to use.
cDataFile
类型：String
要打开的数据库文件名，包括可选的驱动器、目录和扩展名。
如果数据库文件有对应的备注文件，也会一并打开。
数据库和备注文件的默认扩展名由 RDD 决定。有关文件搜索和创建规则，请参见 SetDefault() 和 SetPath()。
cAlias
类型：String
打开 cDataFile 时与工作区关联的标识符名称。在单个应用程序中不允许重复的别名。
lShared
类型：Boolean
TRUE 尝试以共享方式打开 cDataFile。FALSE 尝试以独占（非共享）方式打开 xcDataFile，在数据库文件关闭之前拒绝所有其他进程的访问。
lReadOnly
类型：Boolean
TRUE 尝试以只读属性打开 cDataFile，禁止对工作区进行更新。FALSE 尝试以读写属性打开 cDataFile，允许更新。

返回值

类型：Boolean
如果成功则返回 TRUE；否则返回 FALSE。
备注
VODBUseArea() 是用于实现 DBUseArea() 的强类型函数。
此函数不调用错误处理程序，因此在失败时不会产生运行时错误消息或创建错误对象。因此，检查返回值以确定函数是否成功可能很重要。
全局结构 StrucErrInfo 将包含有关发生的任何错误的必要信息。有关更多信息，请参见 DBUseArea()。
示例
这个例子是 VODBUseArea() 函数的典型用法：
X#
复制
 1FUNCTION NtxUse(cDBF AS STRING) AS LOGIC PASCAL
 2    LOCAL n,i           AS DWORD
 3    LOCAL rddList       AS _RDDLIST
 4    LOCAL aRdds         AS ARRAY
 5    LOCAL lRet        <br />
 6AS LOGIC
 7    aRdds := {"CAVODBF", "DBFNTX"}
 8    n       := ALen(aRdds)
 9    rddList := MemAlloc( (_SizeOf(DWORD)) + (n * _SizeOf(SYMBOL)) )
10    rddList.uiRddCount := n
11    FOR i := 1 TO n
12        rddList.atomRddName[i] := SysAddAtomUpperA(aRdds[i])
13    NEXT
14    lRet := VODBUseArea(TRUE, rddList, cDBF, "", TRUE, FALSE)
15    MemFree(rddList)
16    RETURN lRet
参见