substituição

Elemento de string de substituição. Opcional nos elementos <rule>.

Atributos

Nenhum.

Dados

Sequência de substituição.

Descrição

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

Se a expressão de padrão incluir subexpressões (delimitadas com 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 string de substituição será anexada ao caminho ou query.

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

OBSERVAÇÃO

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

Observação

A cadeia de caracteres 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 incluída em uma seção CDATA XML:

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

Nesta página