Functions.DbCopyXStruct 方法 | |
将数据库文件结构中的字段定义复制到结构扩展文件中作为数据。
命名空间:
XSharp.RT
程序集:
XSharp.RT (在 XSharp.RT.dll 中) 版本:2.22 GA
语法 FUNCTION DbCopyXStruct(
cTargetFile AS STRING
) AS LOGIC
public static bool DbCopyXStruct(
string cTargetFile
)
查看代码参数
- cTargetFile
- 类型:String
目标结构扩展数据库文件的名称,包括可选的驱动器、目录和扩展名。有关文件搜索和创建规则,请参见 SetDefault() 和 SetPath()。
数据库文件的默认扩展名由 RDD 确定。
如果 cTargetFile 不存在,则创建它。
如果文件存在,此函数会尝试以独占模式打开文件,如果成功,则会覆盖文件,不会发出警告或错误。
如果因为其他进程正在使用该文件等原因而被拒绝访问,NetErr() 将被设置为 TRUE。
DBCreate() 根据 SetAnsi() 设置,以 ANSI 或 OEM 字符集格式创建指定的文件。(有关更多信息,请参阅 SetAnsi() 函数。)
返回值
类型:
Boolean
如果成功则返回 TRUE;否则返回 FALSE。
备注
DBCopyXStruct() 创建一个数据库文件,其内容是当前数据库文件的结构,每个字段的定义对应一条记录。
默认情况下,此函数在当前选定的工作区上操作。
可以通过在别名表达式中指定来使其在未选定的工作区上操作。
结构扩展数据库文件具有以下结构:
名称 类型 长度 小数位
Field_Name 字符 10
Field_Type 字符 1
Field_Len 数值 3 0
Field_Dec 数值 3 0
在应用程序中使用 DBCopyXStruct() 允许您以编程方式创建或修改数据库文件的结构。
要从结构扩展文件创建新的数据库文件,请使用 CREATE FROM。
如果您需要一个空的结构扩展文件,请使用 CREATE。
DBCopyXStruct() 是 COPY STRUCTURE EXTENDED 命令的功能实现。
提示: |
---|
长度大于 255 的字符字段:大于 255 的字段长度表示为 Field_Dec 和 Field_Len 字段的组合。
执行 DBCopyXStruct() 后,您可以使用以下公式确定任何字符字段的长度:
1nFieldLen := If((Field_Type = "C" .AND. ;
2 Field_Dec != 0), Field_Dec * 256 + ;
3 Field_Len, Field_Len) |
示例
以下示例创建一个新的结构扩展文件:
1USE test
2IF Used()
3 DBCopyXStruct("stru.dbf")
4ENDIF
参见