<xmlpoke>

Replaces text in an XML file at the location specified by an XPath expression.

The location specified by the XPath expression must exist, it will not create the parent elements for you. However, provided you have a root element you could use a series of the tasks to build the XML file up if necessary.

Parameters

Attribute

Type

Description

Required

file

file

The name of the file that contains the XML document that is going to be poked.

True

value

string

The value that replaces the contents of the selected nodes.

True

xpath

string

The XPath expression used to select which nodes are to be modified.

True

preserveWhitespace

bool

If true then the whitespace in the resulting document will be preserved; otherwise the whitespace will be removed. The default is false.

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.