NAnt
Help
Task Reference
<readregistry> |
v0.85-nightly-2005-10-11 |
[This is preliminary documentation and subject to change.]
Reads a value or set of values from the Windows Registry into one or more NAnt properties.
| Attribute | Type | Description | Required |
|---|---|---|---|
| key | string | The registry key to read, including the path. | True |
| hive | string | Space separated list of registry hives to search for key. For a list of possible values, see RegistryHive. The default is LocalMachine. |
False |
| prefix | string |
The prefix to use for the specified registry key values. If this attribute is used then all registry values will be read and stored as properties with this prefix. |
False |
| property | string |
The property to set to the specified registry key value. If this attribute is used then a single value will be read. |
False |
| 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 |
Read a single value from the registry.
<readregistry property="sdkRoot" key="SOFTWARE\Microsoft\.NETFramework\sdkInstallRoot" hive="LocalMachine" />
Read all the registry values in a key.
<readregistry prefix="dotNetFX" key="SOFTWARE\Microsoft\.NETFramework\sdkInstallRoot" hive="LocalMachine" />