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 Windows / Funciones varias de WINDEV
  • Escritura en un archivo INI en modo Unicode
  • Varios
  • 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
Escribe un valor específico en un archivo INI (o en un archivo estructurado como un archivo.INI). Es posible:
  • escribir el valor de una palabra clave encontrada en una sección específica,
  • crear o borrar una palabra clave,
  • crear o borrar una sección.
Ejemplo
// Store the selected product in the .INI
INIWrite("USER", "LastProd", ...
NumToString(ListSelect(LIST_Product)), ...
fCurrentDir() + "\Port.INI")
WINDEVWEBDEV - Código ServidorReportes y ConsultasCódigo de Usuario (UMC)PHPAjax
Ejemplo de archivo.INI:
[WD examples]
Name1 = WDInstall
Name2 = WDBench
[Description of WDInstall]
Caption = Use the control panel of Windows
LST = 43
Page = 12
// Write into the [WD examples] section
INIWrite("WD examples", "Name3", "WDExample", "C:\Temp\ExamplesLST.INI")
Sintaxis
<Result> = INIWrite(<Section> [, <Keyword> [, <Value> [, <File>]]])
<Result>: booleano
  • True si se realizó la operación,
  • False en caso contrario.
<Section>: Cadena de caracteres
Nombre de la sección donde se realizará la operación de escritura. La sección se crea automáticamente si no existe.
Observación: Este nombre no puede contener el carácter "-".
<Keyword>: Cadena de caracteres opcional
Nombre de la palabra clave que contiene la información a escribir. Esta palabra clave se crea automáticamente si no existe.
La sección se borrará si este parámetro es una cadena vacía (""") o si corresponde a NULL.
iPhone/iPadIOS WidgetMac Catalyst Este parámetro es obligatorio.
<Value>: Cadena de caracteres opcional
Texto a escribir para la palabra clave y la sección especificada. La palabra clave se eliminará si este parámetro es una cadena vacía (""") o si ti corresponde a NULL.
Observación: Este nombre no puede contener el carácter TAB.
PHP Este nombre no puede contener el carácter de comillas.
iPhone/iPadIOS WidgetMac Catalyst Este parámetro es obligatorio.
<File>: Cadena de caracteres opcional
Nombre completo del archivo a completar (con su extensión).
  • El archivo WIN.INI se utilizará si no se especifica este parámetro.
  • Si sólo no se especifica la ruta, el archivo se buscará en el directorio de Windows.
  • El directorio no se creará si no existe.
  • El archivo se creará si no existe en el directorio especificado.
Java Nombre completo del archivo a completar (con su extensión).
  • Si no se especifica este parámetro, el archivo utilizado será el que se llame como el proyecto y se encuentre en el directorio de ejecución de la aplicación.. El archivo se creará si no existe.
  • Si sólo no se especifica la ruta, el fichero se buscará en el directorio de ejecución de la aplicación.
AndroidWidget Android Nombre completo del archivo a completar (con su extensión). Este parámetro puede corresponder a una ruta completa o relativa con respecto al directorio actual (devuelto por la función fCurrentDir). Este parámetro distingue entre mayúsculas y minúsculas.
  • Si no se especifica este parámetro, el archivo utilizado será el que se llame como el proyecto y se encuentre en el directorio de ejecución de la aplicación (directorio actual).. El archivo se creará si no existe.
  • Si sólo no se especifica ruta, el fichero se buscará en el directorio de ejecución de la aplicación (directorio actual).
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).
Universal Windows 10 App Este parámetro es obligatorio. Este parámetro puede corresponder a una ruta completa o a una ruta relativa en relación con el directorio actual.. El directorio actual corresponde al directorio de datos de la aplicación.
Recordatorio: Sólo se pueden manejar los archivos que se encuentran en el directorio de datos associated con la aplicación.
PHP Nombre completo del archivo a rellenar (con su extensión).
  • El archivo PHP.INI se utilizará si no se especifica este parámetro.
  • Si sólo no se especifica la ruta, el archivo se buscará en el directorio actual.. El archivo se creará si no existe.
iPhone/iPadIOS WidgetMac Catalyst Este parámetro es obligatorio. Este parámetro puede corresponder a una ruta completa o relativa con respecto al directorio actual (devuelto por la función fCurrentDir). 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

Escritura en un archivo INI en modo Unicode

Su aplicación funciona en modo Unicode ("Usar cadenas UNICODE en tiempo de ejecución" marcado en la pestaña "Unicode" de la configuración de description).
En este caso, para escribir en un fichero INI, este fichero INI debe estar en formato Unicode, lo que significa que debe tener una cabecera de lista de materiales Unicode..
Ejemplo:
fCreate(gsINIFile, foUnicode) // creates gsINIFile with BOM UNICODE
INIWrite("French", "Country", "French",gsINIFile)
INIWrite("中国","国家", "中国", gsINIFile)

Varios

  • No le aconsejamos que escriba en el archivo WIN.INI.
  • Para escribir en el registro, utilice las funciones específicas del registro: RegistrySetValue, etc.
  • Los archivos INI están limitados a 64 KB (en Windows 98).
WINDEVReportes y ConsultasCódigo de Usuario (UMC)

Windows Vista (y posterior)

Los estándares de programación de Windows no aconsejan escribir:
  • en el archivo WIN.INI
  • en los directorios de sistema (directorio Windows, directorio "Archivos de programa", ....).
En Windows Vista (y posterior) con el mecanismo UAC activadolos privilegios de administrador son necesarios para realizar estas operaciones. Si la aplicación no tiene los privilegios de administrador necesarios, el Mecanismo UAC redirigirá los archivos (llamados de virtualización) a un directorio propio del usuario que está utilizando la aplicación (C:\Usuarios\<LOGIN>AppData\Local\VirtualStore\Windows\). Los archivos pueden volver a ser leídos por INIRead en la misma aplicación. Este mecanismo de virtualización de archivos es propuesto por Windows Vista (y posterior) para su compatibilidad y no está disponible en 64 bits.
Atención: Si el archivo INI se virtualiza automáticamente con Windows Vista (y posterior), el archivo INI no se puede compartir entre varias aplicaciones (especialmente si estas aplicaciones utilizan privilegios diferentes).
Consejo de programación: Para crear un archivo INI sin tener los privilegios de administrador:
  • no utilice el archivo WIN.INI (debe especificarse el parámetro <Archivo>),
  • 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).
Componente: wd290std.dll
Versión mínima requerida
  • Versión 9
Esta página también está disponible para…
Comentarios
Optional Parameter File
"win.ini" is not used, if no Parameter for file is defined on Windev mobile...
Werner
11 01 2020

Última modificación: 27/05/2022

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