PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN

  • Escritura en un archivo INI en modo Unicode
  • Notas adicionales
  • Windows Vista (y posterior)
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Escribe un valor específico en un archivo INI (o en un archivo estructurado como un archivo.INI). Tú puedes:
  • 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.
Versions 15 and later
Android Esta función ahora está disponible para aplicaciones Android.
New in version 15
Android Esta función ahora está disponible para aplicaciones Android.
Android Esta función ahora está disponible para aplicaciones Android.
Versions 16 and later
Universal Windows 10 App Esta función ahora está disponible para aplicaciones Windows Phone.
New in version 16
Universal Windows 10 App Esta función ahora está disponible para aplicaciones Windows Phone.
Universal Windows 10 App Esta función ahora está disponible para aplicaciones Windows Phone.
Versions 17 and later
iPhone/iPad Esta función ahora está disponible para aplicaciones iPhone/iPad.
New in version 17
iPhone/iPad Esta función ahora está disponible para aplicaciones iPhone/iPad.
iPhone/iPad Esta función ahora está disponible para aplicaciones iPhone/iPad.
Versions 18 and later
Android Widget Esta función ahora está disponible en modo Android Widget.
Universal Windows 10 App Esta función ahora está disponible en modo Windows Store apps.
New in version 18
Android Widget Esta función ahora está disponible en modo Android Widget.
Universal Windows 10 App Esta función ahora está disponible en modo Windows Store apps.
Android Widget Esta función ahora está disponible en modo Android Widget.
Universal Windows 10 App Esta función ahora está disponible en modo Windows Store apps.
Versions 21 and later
Universal Windows 10 App Esta función ahora está disponible en modo Universal Windows 10 App.
New in version 21
Universal Windows 10 App Esta función ahora está disponible en modo Universal Windows 10 App.
Universal Windows 10 App Esta función ahora está disponible en modo Universal Windows 10 App.
Example
// Store the selected product in the .INI
INIWrite("USER", "LastProd", ...
NumToString(ListSelect(LIST_Product)), ...
fCurrentDir() + "\Port.INI")
WINDEVWEBDEV - Server codeReports and QueriesWindows MobilePHPAjaxUser code (UMC)
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")
Syntax
<Result> = INIWrite(<Section> [, <Keyword> [, <Value> [, <File>]]])
<Result>: Boolean
  • True si se realizó la operación,
  • False en caso contrario.
<Section>: Character string (with quotes)
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>: Optional character string (with quotes)
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.
Versions 17 and later
iPhone/iPad Este parámetro es obligatorio.
New in version 17
iPhone/iPad Este parámetro es obligatorio.
iPhone/iPad Este parámetro es obligatorio.
<Value>: Optional character string (with quotes)
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.
Versions 17 and later
iPhone/iPad Este parámetro es obligatorio.
New in version 17
iPhone/iPad Este parámetro es obligatorio.
iPhone/iPad Este parámetro es obligatorio.
<File>: Optional character string (with quotes)
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.
Windows Mobile Nombre completo del archivo a rellenar (con su extensión). El archivo se creará si no existe.
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.
Versions 15 and later
AndroidAndroid Widget 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 tiene derecho a escribir en el directorio de instalación o en uno de los subdirectorios, así como en la memoria externa (SDCard).
New in version 15
AndroidAndroid Widget 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 tiene derecho a escribir en el directorio de instalación o en uno de los subdirectorios, así como en la memoria externa (SDCard).
AndroidAndroid Widget 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 tiene derecho a escribir en el directorio de instalación o en uno de los subdirectorios, así como en la memoria externa (SDCard).
Versions 16 and later
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.
New in version 16
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.
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.
Versions 17 and later
iPhone/iPad 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.
New in version 17
iPhone/iPad 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.
iPhone/iPad 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.
Remarks
Versions 17 and later

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 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)
New in version 17

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 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)

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 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)

Notas adicionales

  • 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).
WINDEVReports and QueriesUser code (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 requeridos, Mecanismo UAC redirigirá los archivos (llamados virtualización) a un directorio específico del usuario que está usando la aplicación (C:\Users\<LOGIN>AppData\Local\VirtualStore\Windows\). Los archivos pueden ser leídos de nuevo por INIRead utilizados 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 directorio "Archivos de programa",
  • utilizar el directorio del sistema que corresponde a la aplicación (devuelto por la función SysDir y la constante srCommonAppData).
Component : wd260std.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Optional Parameter File
"win.ini" is not used, if no Parameter for file is defined on Windev mobile...
Werner
11 Jan. 2020