Contexto global

BeginFindingFiles

Sintaxis:

BeginFindingFiles(<DescripciónCallback>, <Ruta>, <Máscara>, <BuscarEnSubdirectorios>)

Parámetros:

Tipo: DescripciónCallback.
Contiene la descripción del procedimiento que se llamará al completarse con los siguientes parámetros:

• <ArchivosEncontrados> – establece la matriz de valores de tipo Archivo.
• <ParámetrosAdicionales> – valor especificado cuando se creó el objeto DescripciónCallback.

Tipo: Cadena.
Ruta del directorio a buscar. El directorio puede estar en una red local o en un servidor FTP. Con estos esquemas, debe usar una barra diagonal ‘/’ y no una barra invertida ‘\’.
Se supone la instrucción de un nombre completo de archivo (ruta + nombre).

Tipo: Cadena.
Una máscara de selección de archivos.
Si se especifica este parámetro, el primer parámetro se trata como una ruta al directorio en el que se buscarán archivos que coincidan con la máscara.
Para Microsoft Windows:
La máscara puede incluir los siguientes caracteres comodín: * (cualquier número de cualquier carácter) y ? (cualquier carácter).
Para Linux, macOS, iOS y Android:
La máscara puede incluir los siguientes caracteres y comodines:

• Cualquier carácter permitido en los nombres de archivo:
  • Para Linux, macOS – distingue entre mayúsculas y minúsculas
  • Para iOS y Android – no distingue entre mayúsculas y minúsculas
• * (cualquier número de cualquier carácter)
• ? (cualquier carácter)
• [ (una clase de caracteres). Especifique una secuencia de caracteres después del corchete de apertura. Cualquiera de estos caracteres coincide con el filtro. Puede especificar un rango de caracteres usando un guión (-). Un corchete de cierre (]) designa el final de la clase de caracteres. Para incluir un guión en el conjunto de caracteres, especifíquelo en la primera o última posición. Un signo de exclamación (!) después del corchete de apertura especifica que todos los caracteres excepto los enumerados coinciden con el filtro.

Ejemplo:

Tipo: Booleano.
Verdadero – búsqueda en directorios anidados en el parámetro <Ruta>.
El parámetro se ignora si no se especifica el parámetro <Máscara>, porque se supone que se está buscando un solo archivo.
Valor predeterminado: Falso.

Descripción:

Activa la búsqueda basada en la máscara especificada de archivos y catálogos en el catálogo especificado.

Disponibilidad:

Cliente ligero, cliente web, cliente móvil, cliente grueso, aplicación móvil (cliente).

Nota:

Para utilizar el método en el cliente web, debe adjuntar previamente la extensión para trabajar con archivos.

Consulte también:

Contexto global, método FindFiles
Contexto global, método FindFilesAsync

Disponible desde:

Disponible desde la versión 8.3.6.

Descripción cambiada en la versión 8.3.18.