Formato Especial CMSM
Alguns valores usados com os módulos de mesclagem configuráveis exigem um tratamento de texto especial. Uma cadeia de texto descrita como estando no "Formato Especial CMSM" trata os caracteres de ponto e vírgula (;) e é igual a (=) como caracteres reservados usados pela ferramenta de mesclagem do cliente ou pelo Mergemod.dll.
Atualmente, o Formato Especial CMSM é usado nos seguintes locais:
- A coluna Row da tabela ModuleSubstitution.
- A coluna Value 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 usados pelo método ProvideTextData.
Para inserir caracteres literais de ponto e vírgula ou de igualdade em um valor no formato especial CMSM, coloque um caractere de barra invertida ('\') como prefixo do caractere. Uma barra invertida literal pode ser representada por duas barras invertidas. Um caractere individual prefixado por uma barra invertida é convertido no caractere único, mesmo que o escape do caractere não seja necessário.
Se um caractere de ponto e vírgula ou de igualdade não tiver uma barra invertida como prefixo e ainda 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 de ponto e vírgula é o delimitador de coluna. Embora o caractere de igualdade não tenha nenhum significado especial nessa cadeia de caracteres, os caracteres literais de igualdade ainda precisam usar caracteres de escape nessa cadeia de caracteres.