Replacement Dynamic Value

This will replace any number of parameters into a format string. The format string can also include formats for each parameter.

Version

Available from version 1.5

Examples

Basic example

<nant>
  <!-- Omitted for brevity -->
  <buildArgs>-t:Help</buildArgs>
  <dynamicValues>
    <replacementValue property="buildArgs">
      <format>-t:{0}</format>
      <parameters>
        <namedValue name="CommandToRun" value="Help" />
      </parameters>
    </replacementValue>
  </dynamicValues>
</nant>

Shorthand example

<nant>
  <!-- Omitted for brevity -->
  <buildArgs>-t:$[CommandToRun|Help]</buildArgs>
</nant>

Example in context

<project name="Test Project">
  <sourcecontrol type="svn">
    <!-- Omitted for brevity -->
  </sourcecontrol>
  <triggers>
    <intervalTrigger />
  </triggers>
  <tasks>
    <nant>
      <!-- Omitted for brevity -->
      <buildArgs>-t:Help</buildArgs>
      <dynamicValues>
        <replacementValue property="buildArgs">
          <format>-t:{0}</format>
          <parameters>
            <namedValue name="CommandToRun" value="Help" />
          </parameters>
        </replacementValue>
      </dynamicValues>
    </nant>
    <!-- Omitted for brevity -->
  </tasks>
  <publishers>
    <!-- Omitted for brevity -->
  </publishers>
  <parameters>
    <!-- Omitted for brevity -->
  </parameters>
</project>

Configuration Elements

Element	Description	Type	Required	Default	Version
format	The default value to use if nothing is set in the parameters.	String	Yes	n/a	1.5
parameters	The parameters to use.	Named Value array	Yes	n/a	1.5
property	The name of the property to set.	String	Yes	n/a	1.5

Notes

The format string is any standard .NET format string that can be used with string.Format(). The parameters will be replaced in the order that they are defined in the parameters property.

Automatically Generated

Documentation generated on Saturday, 5 Dec 2009 at 5:23:58 AM