# <iniread>

[This is preliminary documentation and subject to change.]

Reads String values in INI files.

### Parameters

Attribute | Type | Description | Required
--- | --- | --- | ---
default | string | value to set. | True
filename | string | INI File to Write To. | True
key | string | Key to set the value for. | True
property | string | property where we store the return value. | True
section | string | Section in the INI file. | True
failonerror | bool | Determines if task failure stops the build, or is just reported. The default is true. | False
if | bool | If true then the task will be executed; otherwise, skipped. The default is true. | False
unless | bool | Opposite of `if`. If false then the task will be executed; otherwise, skipped. The default is false. | False
verbose | bool | Determines whether the task should report detailed build log messages. The default is false. | False

### Examples

-     <iniread property="myvar" filename="VendorMISMO2.ini" section="MS Transaction Server" key="AutoRefresh" default="1"/>

  The file contents look like this:

      [MS Transaction Server]
      Executable="VendorMISMO2.dll"
      AutoRefresh=1

### Requirements

Assembly: NAnt.Contrib.Tasks (0.93.5002.0)