substitution substitution
Substitution string element. Optional in <rule>
elements.
Attributes section-a4506fcb765f4f128f7f1f2629b18a6c
None.
Data section-536b941e40a645cc8d3c6d63d6cbe0d7
Substitution string.
Description section-4a64a93f5e1a4d04a2db19166578bf76
Defines a replacement string for the matched string or substring in the path or query.
If the pattern expression includes sub-expressions (delimited with parentheses), the first matched substring 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 substring is removed. If <substitution>
is not specified, the path or query string is not modified.
replace="all"
is specified in the <rule>
,element to which this <substitution>
element belongs. By default, only the first match is replaced with the substitution string.Note section-cedf2adabaaf441c9f598fb0ea180246
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>