DbServer 构造函数 (FileSpec, Object, Object, String, __Array) | |
构造一个服务对象。
命名空间:
XSharp.VO.SDK
程序集:
XSharp.VORDDClasses (在 XSharp.VORDDClasses.dll 中) 版本:2.22 GA
语法 CONSTRUCTOR(
oFS AS FileSpec,
lShareMode AS Object,
lReadOnlyMode AS Object,
xDriver AS STRING,
aRDD AS ARRAY
)
public DbServer(
[DefaultParameterValueAttribute(null, 0)] FileSpec oFS,
[DefaultParameterValueAttribute(null, 0)] Object lShareMode,
[DefaultParameterValueAttribute(null, 0)] Object lReadOnlyMode,
[DefaultParameterValueAttribute("", 0)] string xDriver,
[DefaultParameterValueAttribute(null, 0)] __Array aRDD
)
查看代码参数
- oFS
- 类型:FileSpec
一个带有要打开的文件名的 FileSpec 对象
此参数标识要打开的 DBF 文件。
如果指定了字符串,则它完全对应于 DBUseArea() 函数的文件名参数;它可以包含带有驱动器和目录的完整路径,或仅包含文件名。
如果指定了 FileSpec 对象,则其文件名组件用作要打开的文件。它也可以包含带有驱动器和目录的完整路径,或仅包含文件名。
无论哪种类型的参数,如果仅指定文件名,DBServer 的工作方式与 USE 命令或 DBUseArea() 函数关于默认路径的工作方式相同——例如,
它受 SET PATH 和 SET DEFAULT 的影响。默认情况下假定扩展名为 DBF。
无论哪种情况,在成功创建 DBServer 对象后,它都包含一个带有原始文件规范的 FileSpec 对象。
- lShareMode
- 类型:Object
标识文件是否应以共享模式打开。可以指定为常量 DBSHARED(TRUE) 或 DBEXCLUSIVE(FALSE)。
如果未指定,则默认值由 SetExclusive() 函数确定,该函数默认值为“独占”或 FALSE。
- lReadOnlyMode
- 类型:Object
标识文件是否应以只读模式打开。
可以指定为常量 DBREADONLY(TRUE) 或 DBREADWRITE(FALSE)。如果未指定,则默认值为读写或 FALSE。
- xDriver
- 类型:String
可以指定驱动程序。如果未指定,则默认为 RDDSetDefault() 指定的驱动程序,该驱动程序又默认为 DBFNTX。 - aRDD
- 类型:__Array
一个一维数组,包含主 RDD 继承特殊功能的 RDD 名称。这允许您使用具有特殊功能的 RDD,例如加密或解密,用于具有不同数据库驱动程序的不同数据服务。
这些 RDD 覆盖主 RDD(使用 cDriver 参数指定)的特殊功能。如果多个 RDD(使用此参数指定)实现相同的功能,
则与列表中最后一个 RDD 关联的功能优先。如果省略 aRdds,则不假定有其他 RDD。
返回值
类型:
与所有 Init() 方法一样,实例化返回对象。即使文件未成功打开(可能是因为文件不存在、已损坏或被其他用户锁定),也会创建对象。
因此,在使用 DBServer 错误之前,请验证它是否已通过 DBServer:Used 或 Status 访问方法成功打开。
示例
以下示例演示了构造 DBServer 对象的几种不同方法:
1
2oDBCust := DBServer{"CUSTOMER"}
3
4oDBCust := DBServer{"CUSTOMER",DBSHARED,DBREADONLY, "DBFNTX"}
5
6oFSCust := FileSpec{"d:\data\customer"}
7oDBCust := DBServer{oFSCust,,FALSE}
参见