AdsSQLServer 构造函数 | |
构造一个服务对象。
命名空间:
VO
程序集:
VORDDClasses (在 VORDDClasses.dll 中) 版本:2.22 GA
语法 CONSTRUCTOR(
oFile,
lShareMode,
lReadOnlyMode,
xDriver,
aRDD,
aParams
) CLIPPER
[ClipperCallingConventionAttribute(new string[] { ... })]
public AdsSQLServer(
__Usual oFile = default,
__Usual lShareMode = default,
__Usual lReadOnlyMode = default,
__Usual xDriver = default,
__Usual aRDD = default,
__Usual aParams = default
)
查看代码参数
- oFile (Optional)
- 类型:__Usual
一个带有要打开的文件名的字符串或 FileSpec 对象
此参数标识要打开的 DBF 文件。
如果指定了字符串,则它完全对应于 DBUseArea() 函数的文件名参数;它可以包含带有驱动器和目录的完整路径,或仅包含文件名。
如果指定了 FileSpec 对象,则其文件名组件用作要打开的文件。它也可以包含带有驱动器和目录的完整路径,或仅包含文件名。
无论哪种类型的参数,如果仅指定文件名,DBServer 的工作方式与 USE 命令或 DBUseArea() 函数关于默认路径的工作方式相同——例如,
它受 SET PATH 和 SET DEFAULT 的影响。默认情况下假定扩展名为 DBF。
无论哪种情况,在成功创建 DBServer 对象后,它都包含一个带有原始文件规范的 FileSpec 对象。
- lShareMode (Optional)
- 类型:__Usual
标识文件是否应以共享模式打开。可以指定为常量 DBSHARED(TRUE) 或 DBEXCLUSIVE(FALSE)。
如果未指定,则默认值由 SetExclusive() 函数确定,该函数默认值为“独占”或 FALSE。
- lReadOnlyMode (Optional)
- 类型:__Usual
标识文件是否应以只读模式打开。
可以指定为常量 DBREADONLY(TRUE) 或 DBREADWRITE(FALSE)。如果未指定,则默认值为读写或 FALSE。
- xDriver (Optional)
- 类型:__Usual
可以指定驱动程序。如果未指定,则默认为 RDDSetDefault() 指定的驱动程序,该驱动程序又默认为 DBFNTX。 - aRDD (Optional)
- 类型:__Usual
一个一维数组,包含主 RDD 继承特殊功能的 RDD 名称。这允许您使用具有特殊功能的 RDD,例如加密或解密,用于具有不同数据库驱动程序的不同数据服务。
这些 RDD 覆盖主 RDD(使用 cDriver 参数指定)的特殊功能。如果多个 RDD(使用此参数指定)实现相同的功能,
则与列表中最后一个 RDD 关联的功能优先。如果省略 aRdds,则不假定有其他 RDD。
- aParams (Optional)
- 类型:__Usual
可选的参数值数组
返回值
类型:
与所有 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}
参见