IniFileWrite - method of the Pm object
Description:
Writing the item into the *.ini file.
Syntax:
Boolean IniFileWrite(String sFile, String sSection, String sKey, Variant vWrite)
Parameters:
| sFile | (String) The file name with the path.
If a full path is not entered, then it is completed relative to the application folder.
It is recommended to use the PROMOTIC path syntax - see PROMOTIC path to files or folders. |
|---|
| sSection | (String) Section name (the section is in the INI file inside the square brackets) without the brackets |
|---|
| sKey | (String) Key name of the written item |
|---|
| vWrite | (Variant) Written value |
|---|
Return value:
true - on success
false - on error
Note:
This way of storing the values is appropriate for the portion store of single configurations or for saving only a few values. It is not suitable for the store of bigger amount of values in the real time because the operation is slow (internally the entire
INI file has to be read, the key searched, overwritten and the entire
INI file saved). The operation must be applied for each item (for each key value) separatelly. For the store of bigger amount of values it is better to use the
Pm.FileTextWrite method where the output format can be identical with the INI file, only data are written together.
This method
is not functional in
Web panels.
Example:
JavaScriptVBScriptSelect and copy to clipboard
var bWrite = Pm.IniFileWrite("#cfg:file.ini", "Data", "Value1", "4.56");
Dim bWrite
bWrite = Pm.IniFileWrite("#cfg:file.ini", "Data", "Value1", "4.56")