AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Funciones estándar / Funciones de archivos
  • Códigos de error
  • Archivo extraído
  • Extracción y contraseña
  • ruta almacenada
Extrae y descomprime una lista de archivos encontrados en un archivo a una ubicación física.
Ejemplo
Sintaxis
<Result> = <Archive>.ExtractFileList(<List of paths> [, <Destination> [, <Options> [, <WLanguage procedure> [, <Progress>]]]])
<Result>: Integro
  • 0 si los archivos han sido extraídos,
  • Un código de error (valor superior a 0) en caso contrario. Para más detalles sobre estos códigos de error, consulte la página web de Observaciones.
<Archive>: Variable de tipo zipArchive
Nombre de una Variable de tipo zipArchive correspondiente al archivo a utilizar.
<List of paths>: Cadena de caracteres
Lista de rutas almacenadas de los archivos que se extraerán del archivo comprimido. Las diferentes trayectorias están separadas por caracteres CR (Carriage Return).
Realiza una búsqueda exacta en cada ruta de los archivos encontrados en el archivo.
<Destination>: Cadena de caracteres opcional o constante
Destino ruta de los archivos extraídos:
  • Cadena de caracteres opcional: Los archivos se extraen en la ruta especificada a la que se añade la estructura de árbol del archivo (el disco no se almacena).. Se crea la ruta especificada si no existe.
    Universal Windows 10 App El destino ruta del archivo extraído debe corresponder al directorio de trabajo de la aplicación (devuelto por fDataDir) o a uno de sus subdirectorios.
  • Constante opcional:
    zipDirectory
    (Valor predeterminado)
    Extracción en el directorio actual sin restaurar la estructura de árbol de los archivos (si se ha almacenado).
    zipDriveExtracción:
    • a la ubicación inicial de los archivos si se almacenó y si la unidad existe.
    • mientras restaura la estructura de árbol de los archivos en la unidad actual si la unidad o el directorio almacenado no existe.
    • en el directorio actual si sólo se han almacenado el nombre y la extensión de los archivos.
    iPhone/iPadIOS WidgetMac Catalyst Esta constante no está disponible. Los directorios no tienen raíz.
    AndroidWidget Android Esta constante y la constante zipDirectory tendrán el mismo efecto. Archivos en formato 7z: Esta constante y la constante zipDirectory tendrán el mismo efecto.
    zipNoneExtracción en el directorio actual sin restaurar la estructura de árbol de los archivos (si se ha almacenado).
Universal Windows 10 App Estas constantes no se pueden utilizar.
<Options>: Constante opcional
Configure la extracción (si <Destinos> corresponde a una cadena de caracteres):
zipOverwriteDurante la extracción, los archivos de sólo lectura existentes se sobrescriben automáticamente con los archivos extraídos..
AndroidWidget Android Esta constante no está disponible.
<WLanguage procedure>: Nombre de procedimiento opcional
Nombre del WLanguage Procedure que se llamará si se produce un error al extraer los archivos. Este procedimiento tiene el siguiente formato:
PROCEDURE ProcedureName (<Error Code>, <File Name>)
donde:
  • <Código de error> es un número entero correspondiente al código del error que se produjo al extraer el archivo.
  • <Nombre de archivo> es una cadena de caracteres que contiene la ruta del archivo procesado por .ExtractFileList.
La Procedure puede devolver una de las siguientes constantes:
zipCancelCancela la extracción de archivos del archivo comprimido.
zipIgnoreIgnora el archivo por error.
zipRetryReintenta la extracción de archivos.
AndroidWidget Android Este parámetro no está permitido.
<Progress>: Nombre de control o nombre de Procedure
Modo de gestión de la barra de progreso. Este parámetro puede corresponder a:
  • Universal Windows 10 AppiPhone/iPadMac Catalyst el nombre de un control Barra de progreso encontrado en una ventana. La barra de progreso mostrará el progreso de la extracción de todos los archivos utilizados..
  • el nombre de un WLanguage Procedure. Este procedimiento tiene el siguiente formato:
    <Procedure name> (<Current file>, <Global progress percentage>,
    <File progress percentage >)

    donde:
    • <El archivo actual> corresponde al nombre del archivo actualmente procesado..
    • <El porcentaje de progreso global corresponde al porcentaje de progreso de la extracción de archivos del archivo..
    • <El porcentaje de progreso del archivo corresponde al porcentaje de progreso del archivo que se está extrayendo del archivo.
Si está utilizando un archivo:
  • en formato TAR o TGZ (TAR.GZ)la barra de progreso se actualiza al final de la extracción de cada archivo.
  • en formato CAB y RARla barra de progreso se actualiza al final de la extracción de cada archivo.
  • en formato 7z, sólo se especifica <Porcentaje de progreso general>. <El porcentaje de progreso del archivo tendrá el mismo valor.
Observaciones

Códigos de error

Se devuelven los siguientes códigos de error:
  • 1: La ruta pasada como parámetro no existe.
  • 2: Acceso denegado: el usuario no tiene suficientes derechos.
  • 3: El archivo está corrupto.
  • 4: La ruta no existe en el archivo.
  • 6: Los archivos de los subarchivos no están ordenados (cuando se extraen de un archivo de varias partes).
  • 21: La contraseña especificada no es correcta.
El mensaje correspondiente al código de error es devuelto por zipMsgError.
Observaciones:
  • Universal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst Sólo están disponibles los archivos ZIP, TAR y TGZ (TAR.GZ).
  • AndroidWidget Android Sólo están disponibles los archivos ZIP.

Archivo extraído

Los archivos extraídos no se eliminan del archivo. Para eliminar un fichero o todos los ficheros del archivo, utilice .DeleteFile o .DeleteAll.
Universal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst

Extracción y contraseña

Si el archivo no está encriptado y si se utilizó zipPassword:
  • Archivo en formato WDZ: El archivo se sigue extrayendo.
  • Archivo en formato ZIP: Se produce un error.

ruta almacenada

A continuación, tabla presenta las rutas almacenadas en el archivo según:
  • el acceso ruta al fichero,
  • la sección ruta almacenada.
El directorio actual es: "C:\Temp".
zipAddFileUbicación del archivozipNonezipDirectoryzipDrive
zipAddFile("Archi",
"Archivo.txt")
C:\Temp\Archivo.txtArchivo.txtArchivo.txtArchivo.txt
zipAddFile("Archi",
"Data\Archivo.txt")
C:\Temp\Data\Archivo.txtArchivo.txtData\Archivo.txtData\Archivo.txt
zipAddFile("Archi",
"D:\Data\Archivo.txt")
D:\Data\Archivo.txtArchivo.txtData\Archivo.txtD:\Data\Archivo.txt


Observación: Si se utiliza la constante zipDrive:
  • el formato WDZ almacena la ruta completa del archivo (incluyendo la letra de la unidad).
  • el formato ZIP no almacena la letra de la unidad.
  • el formato 7z almacena sólo los directorios.
AndroidWidget Android La constante zipDrive es equivale a la constante zipDirectory.
Universal Windows 10 App El directorio y el disco no se almacenan en el archivo ruta. Sólo se almacenan el nombre y la extensión del archivo.
Componente: wd290zip.dll
Versión mínima requerida
  • Versión 24
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 22/06/2023

Señalar un error o enviar una sugerencia | Ayuda local