Functions.DbApp 方法 | |
从数据库文件导入记录。
命名空间:
XSharp.RT
程序集:
XSharp.RT (在 XSharp.RT.dll 中) 版本:2.22 GA
语法 FUNCTION DbApp(
cSourceFile,
acFields,
cbForCondition,
cbWhileCondition,
nNext,
nRecord,
lRest,
cDriver,
acRDDs
) AS LOGIC CLIPPER
[ClipperCallingConventionAttribute(new string[] { ... })]
public static bool DbApp(
__Usual cSourceFile = default,
__Usual acFields = default,
__Usual cbForCondition = default,
__Usual cbWhileCondition = default,
__Usual nNext = default,
__Usual nRecord = default,
__Usual lRest = default,
__Usual cDriver = default,
__Usual acRDDs = default
)
查看代码参数
- cSourceFile (Optional)
- 类型:__Usual
要添加记录的数据库文件名,包括可选的驱动器、目录和扩展名。
有关文件搜索和创建规则,请参见 SetDefault() 和 SetPath()。
数据库文件的默认扩展名由 RDD 确定。
此函数尝试以共享模式打开 cSourceFile。
如果文件不存在,则引发运行时错误。
如果文件成功打开,操作继续进行。
如果由于另一个进程独占使用该文件等原因而被拒绝访问,NetErr() 将被设置为 TRUE。
- acFields (Optional)
- 类型:__Usual
要从 cSourceFile 追加的字段列表。
默认为所有字段。
只有两个文件中名称和类型相同的字段才会被追加。
如果同名字段的数据类型不匹配,将引发运行时错误。
- cbForCondition (Optional)
- 类型:__Usual
定义范围内每条记录必须满足的条件的代码块,以便进行处理。 - cbWhileCondition (Optional)
- 类型:__Usual
定义每条记录必须满足的另一个条件的代码块,以便进行处理。 一旦遇到导致条件失败的记录,操作就会终止。
如果未指定范围,cbWhileCondition 会将默认范围更改为 lRest。
您可以使用这三个互斥参数之一来定义范围。
默认是所有记录。
- nNext (Optional)
- 类型:__Usual
要处理的记录数,从 nRecord 开始。 指定 0 以忽略此参数。 - nRecord (Optional)
- 类型:__Usual
要处理的单个记录号。指定 0 以忽略此参数。 - lRest (Optional)
- 类型:__Usual
TRUE 仅处理从 nStart 到文件末尾的记录。 FALSE 处理所有记录。 - cDriver (Optional)
- 类型:__Usual
将为数据服务器提供服务的 RDD 的名称。如果未指定,则使用由 RDDSetDefault() 确定的默认 RDD。
将为工作区提供服务的 RDD 的名称。
如果未指定,则使用由 RDDSetDefault() 确定的默认 RDD。
- acRDDs (Optional)
- 类型:__Usual
一个包含 RDD 名称的一维数组,主 RDD 从中继承特殊功能。
这允许您在具有不同数据库驱动程序的不同工作区中使用具有特殊功能的 RDD,例如加密或解密。
这些 RDD 覆盖主 RDD 的特殊功能(使用 cDriver 参数指定)。
如果多个 RDD(使用此参数指定)实现相同的功能,则列表中最后一个 RDD 关联的功能优先。
如果省略 acRDDs,则不假定有其他 RDD。
返回值
类型:
Boolean
如果成功则返回 TRUE;否则返回 FALSE。
备注 提示: |
---|
nNext、nRecord 和 lRest 参数是互斥的。您不应同时传递这三个参数。
如果您传递 cbWhile 参数,那么它也会控制范围行为。
|
默认情况下,此函数向当前选定工作区中的数据库文件添加记录。
通过在别名表达式中指定,可以使其在未选定的工作区上操作。
DBApp() 不要求数据库文件被独占使用或通过 FLock() 锁定来执行其操作。
在添加每条记录时,X# 自动仲裁新记录的争用。
DBApp() 在功能上等同于不带 DELIMITED 或 SDF 子句的 APPEND FROM 命令。
示例 参见