Выполняет программу или процедуру Visual FoxPro.
Синтаксис:
DO ProgramName1 | ProcedureName [IN ProgramName2] [WITH ParameterList]
Параметры:
ProgramName1
Задает имя программы, которую нужно выполнить.
Если имя программы задано без расширения, Visual FoxPro ищет и пытается выполнить следующие версии программы (в указанном порядке):
Если вы хотите с помощью команды DO выполнить конкретную программу меню, программу формы или запрос, нужно задать соответствующее расширение имени (.MPR, .SPR или .QPR).
ProcedureName
Задает имя процедуры, которую нужно выполнить. Visual FoxPro сначала ищет эту процедуру в составе выполняемой в данный момент программы. Если процедуры там нет, Visual FoxPro ищет ее в файлах процедуры, открытых по команде SET PROCEDURE.
Если задать предложение IN ProgramName2, то Visual FoxPro будет искать процедуру в указанном файле.
В одном исполняемом файле (.EXE) или в одном приложении (.APP) может оказаться несколько процедур с одним именем. Когда вы используете команду DO для запуска процедуры в исполняемой версии или в приложении, Visual FoxPro ищет процедуру только в главной программе исполняемого файла или приложения.
IN ProgramName2
Выполняет процедуру из файла программы, носящего имя ProgramName2.
Найдя файл, Visual FoxPro выполняет процедуру. Если файл программы найти не удается, появляется сообщение "File does not exist" [Файл не существует]. Если файл программы найден, но в нем нет заданной процедуры, появляется сообщение "Procedure is not found" [Процедура не найдена].
WITH ParameterList
Задает параметры для передачи в программу или процедуру. Параметры списка ParameterList могут представлять собой выражения, переменные памяти, литералы, поля или пользовательские функции. По умолчанию параметры передаются в программы и процедуры по ссылке. Чтобы передать параметр по значению, поставьте его в скобки. О том, как передавать параметры по ссылке и по значению, см. тему SET UDFPARMS. Максимальное число параметров, которые можно передать в программу или процедуру, равно 27. Подробнее о передаче параметров см. темы LPARAMETERS и PARAMETERS.
Комментарии:
Команда DO выполняет программу или процедуру Visual FoxPro, которая находится в файле программы или в файле процедуры. Файл программы сам может содержать другие команды DO, что позволяет организовать до 128 уровней вложенных команд DO.
Когда вы запускаете программу с помощью команды DO, начинают выполняться команды, содержащиеся в файле программы, и это происходит до тех пор, пока не возникнет одна из следующих ситуаций:
Когда выполнение программы завершится, управление возвращается в соответствующую среду, одну из следующих трех:
Если вы выбрали в меню Program команду Do и выполняете программу из каталога или диска, отличных от используемых по умолчанию, Visual FoxPro автоматически принимает каталог и диск с этой программой в качестве используемых по умолчанию.