Команда DO

Выполняет программу или процедуру Visual FoxPro.

Синтаксис

DO ProgramName1 | ProcedureName
[IN ProgramName2]
[WITH ParameterList]

Параметры

ProgramName1

Задает имя программы, которую нужно выполнить.

Если имя программы задано без расширения, Visual FoxPro ищет и пытается выпол ить следующие версии программы (в указанном порядке):

.EXE (исполняемая версия)

.APP (приложение)

.FXP (откомпилированная версия)

.PRG (программа)

Если вы хотите с помощью команды 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, начинают выполняться коман ы, содержащиеся в файле программы, и это происходит до тех пор, пока не возник ет одна из следующих ситуаций:

Встретилась команда RETURN.

Выполнена команда CANCEL.

Выдана другая команда DO.

Достигнут конец файла.

Выполнена команда QUIT.

Когда выполнение программы завершится, управление возвращается в соответствующую среду, одну из следующих трех:

В вызывающую программу.

В окно команд.

В операционную систему.

Если вы выбрали в меню Program команду Do и выполняете программу из каталога и и диска, отличных от используемых по умолчанию, Visual FoxPro автоматически п инимает каталог и диск с этой программой в качестве используемых по умолчанию.