substituição

Elemento da cadeia de caracteres de substituição. Opcional em elementos <rule>.

Atributos

Nenhum.

Dados

Sequência de caracteres de substituição.

Descrição

Define uma string de substituição para a string ou a substring correspondente no caminho ou na query.

Se a expressão de padrão incluir subexpressões (delimitadas por parênteses), a primeira substring correspondente será substituída pela string de substituição. Se a expressão de padrão não incluir subexpressões, toda a string correspondente será substituída.

Se <expression> estiver vazio ou ausente, a cadeia de caracteres de substituição será anexada ao caminho ou à consulta.

Se <substitution> estiver vazio, a cadeia de caracteres ou a subcadeia correspondente será removida. Se <substitution> não for especificado, o caminho ou a sequência de consulta não será modificada.

OBSERVAÇÃO

Todas as correspondências na cadeia de caracteres de entrada são substituídas quando replace="all" é especificado no elemento <rule>, ao qual este elemento <substitution> pertence. Por padrão, somente a primeira correspondência é substituída pela string de substituição.

Observação

A sequência de substituição não deve conter caracteres literais < e &. Esses caracteres reservados podem ser codificados com & e <, respectivamente, ou a sequência inteira pode ser codificada em uma seção CDATA XML:

<substitution><![CDATA[&text=<Hello, world!>]]></ substitution>