# <record>

[This is preliminary documentation and subject to change.]

A task that records the build's output to a file. Loosely based on Ant's Record task.

This task allows you to record the build's output, or parts of it to a file. You can start and stop recording at any place in the build process.

### Parameters

Attribute | Type | Description | Required
--- | --- | --- | ---
action | ActionType | Action to apply to this log instance - either `Start`, `Stop`, `Close` or `Flush`. | True
name | file | Name of destination file. | True
autoflush | bool | Determines whether the recorder will flush it's buffer after every write to it. The default is false. | False
level | Level | Determine the level of logging - either `Debug`, `Verbose`, `Info`, `Warning` or `Error`. The default is `Info`. | 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

### Examples

-     <record name="${outputdir}\Buildlog.txt" level="Info" action="Start"/>
      <record name="${outputdir}\Buildlog.txt" action="Close"/>

### Requirements

Assembly: NAnt.Contrib.Tasks (0.93.5002.0)