SET REPROCESS 命令

指定锁定尝试失败后锁定文件或记录的次数或持续时间。

语法

  
SET REPROCESS TO nAttempts [SECONDS] | TO AUTOMATIC  

参数

TO nAttempts[SECONDS]
指定在初始尝试失败后尝试锁定记录或文件的次数或秒数。 默认值为 0;最大值为 32,000。

SECONDS 指定 Visual FoxPro 尝试锁定文件或记录 nAttempts 秒。 仅当 nAttempts 大于零时,它才可用。

例如,如果 nAttempts 为 30,Visual FoxPro 将尝试锁定记录或文件最多 30 次。 如果还包括 SECONDS (SET REPROCESS TO 30 SECONDS) ,Visual FoxPro 将连续尝试锁定记录或文件长达 30 秒。

如果 ON ERROR 例程生效,并且命令尝试锁定记录或文件失败,则执行 ON ERROR 例程。 但是,如果某个函数尝试锁定,则不会执行 ON ERROR 例程,并且该函数返回 False (.F.) 。

如果 ON ERROR 例程未生效,则命令尝试锁定记录或文件,并且无法放置锁,则会生成错误。 如果某个函数尝试放置锁,则不会显示警报,并且该函数返回 False (.F.) 。

如果 nAttempts 为 0 (默认值) 并且发出尝试锁定记录或文件的命令或函数,则 Visual FoxPro 将尝试无限期锁定记录或文件。 如果在等待时记录或文件可供锁定,则会放置锁定并清除系统消息。 如果某个函数尝试放置锁,该函数将返回 True (.T.) 。

如果 ON ERROR 例程生效,并且命令尝试锁定记录或文件,则 ON ERROR 例程优先于锁定记录或文件的其他尝试。 将立即执行 ON ERROR 例程。 Visual FoxPro 不会尝试其他记录或文件锁定,也不会显示系统消息。

如果 nAttempts 为 1,Visual FoxPro 将尝试无限期锁定记录或文件,并且不会执行 ON ERROR 例程。

如果另一个用户已将锁置于您尝试锁定的记录或文件上,则必须等待该用户释放该锁。

TO AUTOMATIC
指定 Visual FoxPro 尝试无限期锁定记录或文件。 (SET REPROCESS TO -2 是等效的命令。)

注解

首次尝试锁定记录或文件并不总是成功。 通常,记录或文件被网络上的另一个用户锁定。 SET REPROCESS 确定 Visual FoxPro 在初始尝试失败时是否进行其他尝试来锁定记录或文件。 可以指定进行其他尝试的次数或尝试的时长。 ON ERROR 例程会影响如何处理不成功的锁尝试。