Substitution string element. Optional in <rule>
elements.
None.
Substitution string.
Defines a replacement string for the matched string or sub-string in the path or query.
If the pattern expression includes sub-expressions (delimited with parentheses), the first matched sub-string is replaced with the substitution string. If the pattern expression does not include sub-expressions, the entire matched string is substituted.
If <expression>
is empty or absent, the substitution string is appended to the path or query.
If <substitution>
is empty, the matched string or sub-string is removed. If <substitution>
is not specified, the path or query string is not modified.
The substitution string must not contain literal < and & characters. These reserved characters can be encoded with &
and <
, respectively, or the entire string can be enclosed in an XML CDATA
section:
<substitution><![CDATA[&text=<Hello, world!>]]></ substitution>