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 externos
  • Mover el archivo
  • Renombrar un directorio
  • Cómo cambiar el nombre de un archivo de datos HFSQL
  • Gestión de errores
  • Modo de funcionamiento en Windows Vista (y posterior)
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Modifica el nombre de un archivo.
WINDEVWEBDEV - Código ServidorReportes y ConsultasJavaCódigo de Usuario (UMC)PHPAjax
// Modify the name of a file
Res = fRename("C:\Directory\File.doc", "C:\Directory\RenamedFile.doc")
 
 
// Modify the name of the file while moving the file
Res = fRename("C:\Directory\File.doc", "C:\Temp\RenamedFile.doc")
 
// Modify the name of the file while moving the file into the current directory
Res = fRename("C:\Directory\File.doc", "RenamedFile.doc")
Sintaxis
<Result> = fRename(<Path of file to rename> , <New file path>)
<Result>: booleano
  • True si se ha realizado la modificación,
  • False en caso contrario. Para obtener más información sobre el error, utilice la función ErrorInfo con la constante errMessage.
<Path of file to rename>: Cadena de caracteres
  • ruta completa del archivo a renombrar (hasta 260 caracteres). Se puede utilizar una ruta UNC.
  • ruta relativa en relación con el directorio actual (devuelta por fCurrentDir). Los caracteres comodín no están permitidos.
WindowsLinux Este parámetro puede estar en formato Ansi o Unicode.
AndroidWidget Android Este parámetro distingue entre mayúsculas y minúsculas.
Recordatorio: En Android, el sistema de archivos es de solo lectura tanto en el dispositivo y como en el emulador. Una aplicación sólo puede escribir en su directorio instalación o en uno de sus subdirectorios, así como en la memoria externa (SDCard).
iPhone/iPadIOS WidgetMac Catalyst Este parámetro distingue entre mayúsculas y minúsculas.
Recordatorio: En iPhone/iPad, una aplicación solo tiene derecho a escribir en su directorio de instalación o en uno de sus subdirectorios.
<New file path>: Cadena de caracteres
  • ruta completa del archivo con el nuevo nombre (hasta 260 caracteres). Se puede utilizar una ruta UNC.
  • ruta relativa en relación con el directorio actual (devuelta por fCurrentDir).
Los caracteres comodín no están permitidos. Debe existir la ruta del fichero.
WindowsLinux Este parámetro puede estar en formato Ansi o Unicode.
AndroidWidget Android Este parámetro distingue entre mayúsculas y minúsculas.
Recordatorio: En Android, el sistema de archivos es de solo lectura tanto en el dispositivo y como en el emulador. Una aplicación sólo puede escribir en su directorio instalación o en uno de sus subdirectorios, así como en la memoria externa (SDCard).
iPhone/iPadIOS WidgetMac Catalyst Este parámetro distingue entre mayúsculas y minúsculas.
Recordatorio: En iPhone/iPad, una aplicación solo tiene derecho a escribir en su directorio de instalación o en uno de sus subdirectorios.
Observaciones

Mover el archivo

Si la <Ruta del archivo por renombrar> y la <Nueva ruta del archivo> tienen el mismo nombre de archivo pero diferentes rutas de acceso, la función fRename mueve el archivo.

Renombrar un directorio

La función fRename también permite cambiar el nombre de un directorio. Para renombrar un directorio, el directorio a renombrar debe ser diferente del directorio actual de la aplicación.

Cómo cambiar el nombre de un archivo de datos HFSQL

Para renombrar un archivo de datos HFSQL, utilice HChangeName.

Gestión de errores

La función fRename genera un error en los siguientes casos:
  • el archivo a renombrar no existe,
  • el archivo a renombrar está bloqueado,
  • la ruta del archivo a renombrar no es válida,
  • <El nuevo archivo ruta> o <Path del archivo a renombrar> es una cadena vacía,
  • el nuevo archivo ya existe.
Observación: Esta función funciona con un archivo vacío.
WINDEVWEBDEV - Código ServidorReportes y ConsultasCódigo de Usuario (UMC)

Modo de funcionamiento en Windows Vista (y posterior)

Si esta función no funciona correctamente en Windows Vista (y posterior), compruebe si el archivo o directorio utilizado no está en ninguno de los directorios del sistema (directorio de Windows o directorio "Archivos de programa").
En Windows Vista (y posteriores), con el Mecanismo UAC (Cuenta de usuario control) habilitado, debe tener privilegios de administrador para manipular y/o modificar los archivos o directorios en los directorios del sistema (directorio de Windows o directorio "Archivos de programa").
Consejo de programación: A manipular y/o modificar los archivos o directorios sin privilegios de administrador, debería:
  • evite escribir en el directorio de Windows o en el de "Archivos de programa",
  • utilizar el directorio del sistema de la aplicación (devuelto por SysDir con la constante srAppDataCommun, por ejemplo).
Observación: En Windows Vista (y posteriores), el mecanismo de virtualización se utiliza para hacer que las aplicaciones sean compatibles con Vista. Si el archivo se crea en un directorio del sistema sin tener suficientes derechos, este archivo se creará en otro directorio (C:\Users\<LOGIN>AppData\Local\VirtualStore\Windows\). En este caso, el archivo no puede ser compartido entre varias aplicaciones.
Componente: wd290std.dll
Versión mínima requerida
  • Versión 9
Esta página también está disponible para…
Comentarios
Exemplo Renomear Arquivo
b_renomear is boolean=fRename(SAI_Arquivo,SAI_ArquivoNovo)
//frances
b_renomear=fRenomme(SAI_Arquivo,SAI_ArquivoNovo)

mostra_arquivos()

//Blog com Video e Exemplo
http://windevdesenvolvimento.blogspot.com.br/2016/03/curso-windev-arquivos-005-arquivos.html
De matos AMARILDO
23 03 2016

Última modificación: 24/08/2022

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