INIWrite (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Windows management functions

Miscellaneous WINDEV functions

INIWrite

Presentation

Example

Escritura en un archivo INI en modo Unicode

Notas adicionales

Windows Vista (y posterior)

See also

INIWrite (Function)

In french: INIEcrit

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

Esta función ahora está disponible para aplicaciones Android.

New in version 15

Esta función ahora está disponible para aplicaciones Android.

Versions 16 and later

Esta función ahora está disponible para aplicaciones Windows Phone.

New in version 16

Esta función ahora está disponible para aplicaciones Windows Phone.

Versions 17 and later

Esta función ahora está disponible para aplicaciones iPhone/iPad.

New in version 17

Esta función ahora está disponible para aplicaciones iPhone/iPad.

Versions 18 and later

Esta función ahora está disponible en modo Android Widget.

Esta función ahora está disponible en modo Windows Store apps.

New in version 18

Esta función ahora está disponible en modo Android Widget.

Esta función ahora está disponible en modo Windows Store apps.

Esta función ahora está disponible en modo Android Widget.

Esta función ahora está disponible en modo Windows Store apps.

Versions 21 and later

Esta función ahora está disponible en modo Universal Windows 10 App.

New in version 21

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

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
Este parámetro es obligatorio.
New in version 17
Este parámetro es obligatorio.
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.
Este nombre no puede contener el carácter de comillas.
Versions 17 and later
Este parámetro es obligatorio.
New in version 17
Este parámetro es obligatorio.
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.
Nombre completo del archivo a rellenar (con su extensión). El archivo se creará si no existe.
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
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
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).
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
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
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.
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.
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
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
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.
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).

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