DbServer 类

Object
  DataServer
    DbServer
      AdsSQLServer

[TypesChangedAttribute]
 CLASS DbServer INHERIT DataServer

[TypesChangedAttribute]
public class DbServer : DataServer

下表列出了反映当前活动选择的属性和方法： 几个Xbase数据库命令提供了一些选项，用于通过关键字指定操作范围： ALL、REST、NEXT nRecords、RECORD nRecord，以及 FOR 和 WHILE 子句。 这些子句的语义，以及在指定了多个子句时它们的交互方式，都在程序员指南的"Using DBF Files"部分中描述。 相应的 DBServer 方法(如 Average()、AppendDB()、CopyDB()、Sort()、Sum()、Total() 等)允许在调用中作为参数指定 FOR 子句、WHILE 子句和范围。 此外，还可以使用简单的赋值(也提供了相应的访问)设置一个"通用服务范围"。 当在没有明确范围的情况下调用这些批量处理方法时，这个通用范围就会应用。这种方法在许多情况下可能更方便。 例如，要删除接下来的五条记录： 例如，要删除所有剩余的记录： 要计算新泽西州的Smiths的数量： 请记住在后续操作中恢复作用域：作用域是持久的，并且在所有后续基于作用域的方法中都有效，直到被重置。 这种指定作用域的样式带来的便利性也伴随着长时间保持作用域的危险。可以使用 DBServer:ClearScope() 方法或将 NIL 分配给个体组件来重置作用域。 通用服务作用域可以通过以下方式设置： 注意，这种方法不提供指定特定记录号的方式。很少需要处理特定记录(例如，记录5的平均工资)。 在需要时，例如对于 Delete()，使用 RecNo := n, GoTo(n) 或 Seek(Value) 定位服务，然后调用 Delete()。 受通用服务作用域影响的方法包括： 当然，默认作用域是“无作用域”，因此这些方法与相应的命令和函数具有相同的默认行为。 它们大多数处理所有记录或所有剩余记录，取决于作用域如何定义；那些默认为“当前记录”的方法也具有相应的“所有”方法： 但请注意，如果指定了选择性关系，则默认源作用域是选择，而不是整个文件。因此，我们有四个级别的继承，关于操作的作用域： 1. 通过调用参数明确指定的作用域 2. 如果没有提供，则通过 ForBlock、WhileBlock 和Scope 属性设置的作用域 3. 如果没有设置，则指定的选择 4. 如果没有活跃的选择关系，则整个文件例外是 Delete() 和 Recall()，它们使用选项1和2，然后默认为当前记录。 DeleteAll() 和 RecallAll() 应用于当前选择，如果有；否则，应用于整个文件。当然，选择作用域对 Append... 方法不相关，因为条件应用于源文件， 而不是这个服务。 DBServer 编辑器生成了 DBServer 类的子类，一个具有特定信息的子类，如文件名和虚拟字段创建为访问/赋值方法。 不可能使用 DBServer 类来创建数据库文件；文件必须在打开服务之前存在。要创建数据库文件， 使用 DBCreate() (推荐)方法、VODBCreate() 函数或 DBServer 编辑器。 本节描述了在创建多个 DBServer 工作区或服务时使用的共享访问和别名机制，以及混合对象/过程操作。 工作区 创建 DBServer 对象时，会在工作区中打开数据库。没有指定是否应使用新或现有工作区的选项；DBServer 总是使用新工作区。 实例化后，新的工作区并未被选中；在实例化之前选中的工作区仍然保持活跃。因此， 实例化 DBServer 后发出的传统数据库命令和函数不应用于新打开的数据库。正确的操作新 DBServer 的方法是通过其方法。 共享访问 在同一个数据库文件上创建两个 DBServer 对象相当于在两个不同工作区中打开同一个文件。 两个服务(工作区)各自维护自己的位置和记录锁，并作为两个用户共享访问同一个文件的方式操作。 为了允许在同一个数据库文件上创建两个服务(打开同一个文件在两个工作区)，它们必须在共享模式下打开；否则，第二次尝试将产生共享冲突。 然而，这并不会引发错误条件，而是将对象的无效状态存储。使用 DBServer:Status 或 DBServer:Used 属性在实例化后验证文件是否成功打开。 共享模式可以作为实例化参数指定(例如，SetExclusive(FALSE) 在 Start() 函数中)，或作为系统默认(见 DBServer:Init())。 别名 当使用 DBServer 的方法来与数据库工作时，不需要别名；DBServer 对象提供了数据库的句柄。别名在操作 DBServer 对象时不起作用, 但系统内部需要每个工作区的唯一别名。 DBServer 自动构造唯一别名。如果文件在任何其他工作区或服务中未打开，它使用文件名作为传统方式的别名，但如果文件已经打开, 它会通过追加数字创建唯一别名。因此，两次打开 CUSTOMER 文件将产生两个别名 #Customer 和 #Customer_1。 唯一使用别名的原因是执行“混合”操作，使用传统的过程操作与 DBServer 对象。这种做法强烈不推荐, 因为 DBServer 对象可能不知道通过命令完成的操作，DBServer 方法可能在使用过程命令后出现故障 (更多详细信息，请见程序员指南中的“使用 DBF 文件”)。 可以从 DBServer 对象中检索自动生成的别名，以便选择工作区作为过程数据库操作的焦点： 我们在 RDD 类中所做的大多数更改都是为了提高 RDD 类的速度。其中一个更改可能会影响您的应用程序： 在旧实现中，Visual Objects 在每个 DbServer:Method 调用后都会恢复‘当前工作区’。这只有在您混合使用面向对象的 DBF 访问和传统的工作区导向 DBF 访问时才有用。 如果您只做面向对象的 DBF 访问，工作区切换是无必要的，并且可能对应用程序的性能产生负面影响。 因此，我们在 RDD 类中添加了一个开关，允许您启用/禁用这种恢复机制。Visual Objects 2.8 的默认值是 NOT 恢复工作区。这个开关是： 这是一个全局开关，它改变了 DBServer 类的行为。 lEnable 标志的默认值是 FALSE，这意味着工作区恢复被禁用。因此，在每个 DbServer 方法结束时，当前工作区是 DBServer 的工作区。 如果您将 lEnable 标志设置为 TRUE，每个 DBServer 方法在方法结束时都会恢复工作区到方法开始时的工作区值。这是旧行为，但需要一些额外的时间。 DbSetRestoreWorkarea() 的返回值是前一个值。 如果 lEnable 为 NIL，则不设置开关，SetRestoreWorkarea() 只返回当前值。 DbSetRestoreWorkarea() 也改变了内部函数 __DBSetSelect(siNew) 的行为。 如果您调用 DbSetRestoreWorkarea(TRUE)，它是默认的 __DBSetSelect()，与 VODBSetSelect() 相同； 如果您调用DbSetRestoreWorkarea(FALSE)，DBSetSelect() 为空，不做任何事情。