substituição

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

Atributos

Nenhum.

Dados

String de substituição.

Descrição

Define uma cadeia de caracteres de substituição para a cadeia de caracteres ou subcadeia correspondente no caminho ou na consulta.

Se a expressão 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 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 string ou substring 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 na variável <rule>, elemento ao qual isso <substitution> o elemento pertence. Por padrão, somente a primeira correspondência é substituída pela cadeia de caracteres de substituição.

Nota

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 cadeia de caracteres inteira pode ser colocada em uma seção CDATA XML:

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

Nesta página