Share via

DO (Comando)

  • Artículo

Ejecuta un programa o un procedimiento de Visual FoxPro.

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

Parámetros

  • ProgramName1
    Especifica el nombre del programa que se va a ejecutar.

    Si no incluye ninguna extensión con el nombre del programa que se va a ejecutar, Visual FoxPro buscará y ejecutará las versiones del programa en el siguiente orden:

    • .exe (la versión ejecutable)
    • .app (una aplicación)
    • .fxp (la versión compilada)
    • .prg (el programa)

    Para utilizar DO de forma que pueda ejecutar un determinado programa de menú, programa de formulario o consulta, deberá incluir su extensión (.mpr, .spr o .qpr).

  • ProcedureName
    Especifica el nombre de un procedimiento que se va a ejecutar. Visual FoxPro buscará el procedimiento primero en el programa que se está ejecutando en este momento. Si el procedimiento no está allí, lo buscará en los archivos de procedimientos abiertos con SET PROCEDURE.

    Puede incluir la cláusula IN ProgramName2 para indicar a Visual FoxPro que busque el procedimiento en el archivo especificado.

    Es posible que múltiples procedimientos de una versión ejecutable (.exe) o de una aplicación (.app) tengan el mismo nombre. Cuando utilice DO para iniciar un procedimiento en una versión ejecutable o en una aplicación, Visual FoxPro solamente buscará el procedimiento indicado en el programa principal de la versión ejecutable o de la aplicación.

  • IN ProgramName2
    Ejecuta un procedimiento del archivo de programa especificado con ProgramName2.

    Cuando se localiza el archivo, se ejecuta el procedimiento. Si el archivo de programa no se encuentra, aparecerá el mensaje "El archivo no existe". Si se encuentra el archivo de programa pero no se encuentra el procedimiento especificado en el archivo de programa, aparecerá el mensaje "Procedimiento no encontrado".

  • WITH ParameterList
    Especifica los parámetros que se desean transferir al programa o procedimiento. Los parámetros indicados en ParameterList pueden ser expresiones, variables de memoria, literales, campos o funciones definidas por el usuario. De forma predeterminada, los parámetros se transfieren a los programas por referencia. Puede transferir un parámetro por valor si lo escribe entre paréntesis.

    Vea SET UDFPARMS para obtener una explicación de la transferencia de parámetros por valor o por referencia. El número máximo de parámetros que puede transferir a un programa o procedimiento es 27. Para obtener más información acerca de la transferencia de parámetros, vea LPARAMETERS y PARAMETERS.

Observaciones

DO ejecuta un programa o procedimiento de Visual FoxPro dentro de un archivo de programa o de procedimientos. Un archivo de programa puede contener comandos DO adicionales, lo que permite anidar comandos DO hasta 128 niveles.

Cuando utilice DO para ejecutar un programa, los comandos que contenga el archivo de programa se ejecutarán hasta que ocurra alguno de los casos siguientes:

  • Se encuentre RETURN.
  • Se ejecute CANCEL.
  • Se ejecute otro DO.
  • Se alcance el final del archivo.
  • Se ejecute QUIT.

Cuando termina la ejecución de un programa, se devuelve el control a uno de los siguientes:

  • El programa que hace la llamada.
  • La ventana Comandos.
  • El sistema operativo.

Si elige la opción Ejecutar del menú Programa y ejecuta un programa en un directorio o una ruta de acceso distintos del directorio o la ruta de acceso actuales, Visual FoxPro cambiará automáticamente el directorio y la unidad predeterminados al directorio y la unidad que contienen el programa.

Vea también

CLEAR | LPARAMETERS | PARAMETERS | PARAMETERS( ) | PRIVATE | PROCEDURE | PUBLIC | SET DEFAULT | SET DEVELOPMENT | SET PATH | SET PROCEDURE