Navigation:  Actions > Files >

Write INI Action

Previous pageReturn to chapter overviewNext page

This action creates a step to create, update, or delete values in an INI file.  The Read INI action can be used to read values from an INI file.


Filename: Name of the INI file to update (required).  Any non-existent subdirectories will be created before creating the file.  If no path is specified, the file will be created/updated in the Windows folder (%WINDIR% system macro).


Section: Section of the file to update (required).


Value name: Value name to create or delete (optional).  If the value name is empty, the entire section will be deleted if delete is checked.


Delete the value: Deletes the value if checked, otherwise creates/updates the value.


Value data: The string to set the given value to (optional).


Ensure file is not read-only: Removes the read-only attribute of the file before overwriting or appending.


Fail step if file, section, or value not found: If checked and the file, section, or value doesn't exist, the step will fail.  If unchecked, the file, section, and/or value will be created if not found.



Bracket characters [ and ] and the percent sign character % within step fields have special meaning in a step field.
By default, this action is not displayed (existing steps will still be displayed in the Step panes and will build normally).  To show all hidden actions, right-click in the Actions pane and choose Show Hidden.