Formato Especial CMSM

Certos valores usados com módulos de mesclagem configuráveis exigem manipulação de texto especial. Uma cadeia de caracteres de texto descrita como estando em "CMSM Special Format" trata o ponto-e-vírgula (;) e igual a (=) caracteres como caracteres reservados usados pela ferramenta de mesclagem do cliente ou Mergemod.dll.

O formato CMSM Special é atualmente usado nos seguintes locais:

• A coluna Linha da tabela ModuleSubstitution.
• A coluna Valor da tabela ModuleSubstitution.
• A coluna ContextData da tabela ModuleConfiguration quando Bitfield é o valor na coluna Format.
• A coluna ContextData da tabela ModuleConfiguration quando Text é o valor na coluna Format e Enum é o valor na coluna Type.
• A coluna DefaultValue da tabela ModuleConfiguration quando Key é o valor na coluna Format.
• Itens configuráveis no formato Key usado pelo método ProvideTextData.

Para inserir ponto-e-vírgula literal ou caracteres iguais em um valor no formato especial CMSM, prefixe o caractere com um caractere de barra invertida ('\'). Uma barra invertida literal pode ser representada por duas barras invertidas. Um único caractere prefixado por uma única barra invertida é traduzido em um único caractere, mesmo que não seja necessário escapar do caractere.

Se um caractere ponto-e-vírgula ou igual não for prefixado por uma barra invertida, mas não tiver um comportamento definido no contexto do valor, a cadeia de caracteres resultante será indefinida. Por exemplo, a coluna DefaultValue da tabela ModuleConfiguration está no formato especial CMSM para todos os itens Key porque o caractere ponto-e-vírgula é o delimitador de coluna. Embora o caractere igual não tenha nenhum significado especial nessa cadeia de caracteres, caracteres literais iguais ainda devem ser escapados nessa cadeia de caracteres.