LOCFILE( ) (Función)

Busca un archivo en disco y devuelve el nombre del archivo con su ruta de acceso.

LOCFILE(cFileName [, cFileExtensions] [, cFileNameCaption])

Valores devueltos

Character

Parámetros

  • cFileName
    Especifica el nombre del archivo que se va a buscar. Si cFileName sólo incluye un nombre de archivo, LOCFILE( ) buscará primero en el directorio predeterminado de Microsoft Visual FoxPro. Si el archivo no está en el directorio predeterminado, buscará en la ruta de acceso de Visual FoxPro. Utilice SET PATH para especificar la ruta de Visual FoxPro.

    Si cFileName incluye una ruta de acceso y un nombre de archivo, se buscará en el directorio indicado. Si no puede encontrarse el archivo en el directorio indicado, LOCFILE( ) buscará en el directorio predeterminado de Visual FoxPro y luego en la ruta de acceso de Visual FoxPro.

    Si se encuentra el archivo, LOCFILE( ) devolverá el nombre y la ruta del archivo.

  • cFileExtensions
    Especifica las extensiones del archivo que se va a buscar. Si el nombre de archivo que especifica con cFileName no incluye ninguna extensión, Visual FoxPro aplicará las extensiones indicadas en cFileExtensions al nombre de archivo y buscará otra vez el archivo.

    cFileExtensions también especifica las extensiones del nombre de los archivos mostrados en el cuadro de diálogo Abrir cuando no se encuentra el archivo especificado.

    cFileExtensions puede asumir diversas formas:

    • Si cFileExtensions contiene una única extensión (por ejemplo .PRG), únicamente se mostrarán los archivos con esa extensión.

    • cFileExtensions puede contener también caracteres comodín (* y ?) de MS-DOS. Se mostrarán todos los archivos cuyas extensiones cumplan los criterios del comodín. Por ejemplo, si cFileExtensions es ?X?, se mostrarán todos los archivos con la extensión .fxp, .exe o .txt.

    • En Visual FoxPro para Windows, cFileExtensions puede contener una descripción de archivo seguida de una extensión de archivo o de una lista de extensiones de archivo separadas por comas. La descripción del archivo aparece en el cuadro de lista Archivos de tipo. Utilice dos puntos (:) para separar la descripción del archivo de la extensión del archivo o de la lista de extensiones de archivo. Separe con un punto y coma (;) múltiples descripciones de archivo y sus extensiones de archivo.

      Por ejemplo, si cFileExtensions es "Texto:TXT" la descripción de archivo "Texto" aparecerá en el cuadro de lista Archivos de tipo y se mostrarán todos los archivos con la extensión .txt.

      Si cFileExtensions es "Tablas:DBF; Archivos:TXT,BAK" las descripciones de archivo "Tablas" y "Archivos" aparecerán en el cuadro de lista Archivos de tipo. Cuando se elige "Tablas" en el cuadro de lista Archivos de tipo, se mostrarán todos los archivos de extensión .dbf. Cuando se elija "Archivos" del cuadro de lista Archivos de tipo, se mostrarán todos los archivos con la extensión .txt y .bak.

  • cFileNameCaption
    Especifica el texto que desea utilizar para preguntar al usuario. El texto aparecerá a la derecha del cuadro de texto en la que escribió el nombre del archivo. Si lo omite, se mostrará "Nombre de archivo: ".

Si desea consultar una lista de las extensiones de archivo de Visual FoxPro y los correspondientes tipos de archivo, vea el tema en pantalla Extensiones de archivo y tipos de archivo.

Observaciones

El cuadro de diálogo Abrir aparece si no se encuentra el archivo en el directorio predeterminado, en la ruta de acceso de Visual FoxPro ni en una ubicación especificada. Este cuadro de diálogo Abrir puede utilizarse para localizar el archivo. Cuando se elige un archivo en el cuadro de diálogo Abrir, se devuelve el nombre del archivo junto con su ruta de acceso.

Si sale del cuadro de diálogo Abrir eligiendo “Cancelar”, presionando ESC o eligiendo Cerrar en el menú Control, Visual FoxPro generará un mensaje de error y LOCFILE( ) no devolverá ningún valor.

Vea también

FILE( ) | GETFILE( ) | GETPICT( ) | PUTFILE( ) | SET PATH