易语言-数据库帮助文档

易语言-数据库帮助文档

系统核心支持库 (5.0#64版)

--- 命令类别: 数据库 ---

是否支持多用户

调用格式: 〈逻辑型〉是否支持多用户 () - 系统核心支持库->数据库

英文名称:MutiUser

检查本支持库所提供的数据库功能是否支持多用户同时对数据库操作。如果支持，返回真，否则返回假。本命令为初级命令。

操作系统需求: Windows

****************************************************

取错误码

调用格式: 〈整数型〉取错误码 () - 系统核心支持库->数据库

英文名称:GetErrCode

如果执行某数据库命令失败，在其后执行本命令可以取回非 0 的数据库错误码值。如果该数据库命令执行成功，执行本命令将返回 0 。本命令为初级命令。

操作系统需求: Windows

****************************************************

取错误信息

调用格式: 〈文本型〉取错误信息 () - 系统核心支持库->数据库

英文名称:GetErrMsg

如果执行某数据库命令失败，在其后执行本命令可以取回错误信息文本。如果该数据库命令执行成功，执行本命令将返回空文本。本命令为初级命令。

操作系统需求: Windows

****************************************************

创建

调用格式: 〈逻辑型〉创建 (文本型欲创建数据库的文件名，字段信息数组字段信息表) - 系统核心支持库->数据库

英文名称:create

创建指定的数据库文件，如果该数据库文件存在，将被覆盖。成功返回真，失败返回假。本命令为初级命令。

参数<1>的名称为“欲创建数据库的文件名”，类型为“文本型(text)”。

参数<2>的名称为“字段信息表”，类型为“字段信息(FieldInf)”，提供参数数据时只能提供数组数据。参数数组值中顺序指定本数据库中所有字段的信息。

操作系统需求: Windows

****************************************************

打开

(文本型数据库文件名，,文本型在程序中调用格式: 〈逻辑型〉打开

使用的别名,，,逻辑型是否只读,，,整数型共享方式,，,文本型保留参数1,，,文本型数据库密码,，,文本型数组/非数组索引文件表,，... ) - 系统核心支持库->数据库

英文名称:use

打开指定的数据库文件。成功返回真，并自动将当前数据库设置为此数据库，失败返回假。本命令为初级命令。命令参数表中最后一个参数可以被重复添加。

参数<1>的名称为“数据库文件名”，类型为“文本型(text)”。

参数<2>的名称为“在程序中使用的别名”，类型为“文本型(text)”，可以被省略。别名为在后面的程序中引用本数据库时可使用的另一个名称。欲引用一个

已经被打开的数据库可以使用该数据库本身的名称(数据库名称为数据库文件名的无路径和后缀部分。譬如 c:\my documents\gz.edb ，其数据库名称为 gz )，也可以使用在此处所指定的别名。别名主要用作避开重复的数据库名称或者简化对长数据库名的引用。数据库名称与别名皆不区分大小写，在查找数据库时，系统将优先查找别名。如果本参数被省略，默认为没有别名。

参数<3>的名称为“是否只读”，类型为“逻辑型(bool)”，可以被省略。参数值说明是否仅对数据库进行读操作，如果省略本参数，默认为假。

参数<4>的名称为“共享方式”，类型为“整数型(int)”，可以被省略。参数值指定在多用户环境中限制其它用户操作此数据库的方式。如果省略本参数，默认为“#无限制”。方式值可以为以下常量之一:

1、#无限制:允许其它用户任意操作此数据库;

2、#禁止读:禁止其它用户读此数据库;

3、#禁止写:禁止其它用户写此数据库;

4、#禁止读写:独占使用此数据库，禁止其它用户的任何操作。

参数<5>的名称为“保留参数1”，类型为“文本型(text)”，可以被省略。本参数仅用作保留参数位置。

参数<6>的名称为“数据库密码”，类型为“文本型(text)”，可以被省略。本参数提供访问数据库时所需要的密码，如果该数据库没有被加密，请提供空文本。注意“?”(即单个问号)是一个特殊的密码文本，它要求系统当发现所欲打开的数据库具有密码保护时，自动弹出一个密码输入框提示用户输入正确的密码。如果用户在该输入框中取消输入或连续三次输入了错误密码，打开命令将失败，且执行“取错误码”命令将返回-78。如果本参数被省略，默认为空文本。

参数<7>的名称为“索引文件表”，类型为“文本型(text)”，可以被省略，

提供参数数据时可以同时提供数组或非数组数据。本参数的各参数值顺序指定本数据库的所有索引文件，它们将被同步打开，以便得到及时更新。

操作系统需求: Windows

****************************************************

替换打开

调用格式: 〈逻辑型〉替换打开 (文本型数据库文件名，,文本型在程序中使用的别名,，,逻辑型是否只读,，,整数型共享方式,，,文本型保留参数1,，,文本型数据库密码,，,文本型数组/非数组索引文件表,，... ) - 系统核心支持库->数据库

英文名称:ruse

打开指定的数据库文件。成功返回真，并自动关闭当前数据库后将当前数据库设置为此数据库，失败返回假。本命令为初级命令。命令参数表中最后一个参数可以被重复添加。

参数<1>的名称为“数据库文件名”，类型为“文本型(text)”。

参数<2>的名称为“在程序中使用的别名”，类型为“文本型(text)”，可以

被省略。别名为在后面的程序中引用本数据库时可使用的另一个名称。欲引用一个已经被打开的数据库可以使用该数据库本身的名称(数据库名称为数据库文件名的无路径和后缀部分。譬如 c:\my documents\gz.edb ，其数据库名称为 gz )，也可以使用在此处所指定的别名。别名主要用作避开重复的数据库名称或者简化对长数据库名的引用。数据库名称与别名皆不区分大小写，在查找数据库时，系统将优先查找别名。如果本参数被省略，默认为没有别名。

参数<3>的名称为“是否只读”，类型为“逻辑型(bool)”，可以被省略。参

数值说明是否仅对数据库进行读操作，如果省略本参数，默认为假。