CMSM-Spezialformat
Bestimmte Werte, die mit konfigurierbaren Mergemodulen verwendet werden, erfordern eine spezielle Textbehandlung. Eine Textzeichenfolge, die mit „CMSM-Spezialformat“ beschrieben wird, behandelt die Zeichen Semikolon (;) und Gleichheitszeichen (=) als reservierte Zeichen, die vom Client-Mergetool oder von der Mergemod.dll verwendet werden.
Das CMSM-Spezialformat wird derzeit an den folgenden Stellen verwendet:
- Spalte „Row“ der Tabelle „ModuleSubstitution“.
- Spalte „Value“ der Tabelle „ModuleSubstitution“.
- Spalte „ContextData“ der Tabelle „ModuleConfiguration“, wenn die Spalte „Format“ den Wert „Bitfield“ aufweist.
- Spalte „ContextData“ der Tabelle „ModuleConfiguration“, wenn die Spalte „Format“ den Wert „Text“ aufweist und die Spalte „Type“ den Wert „Enum“.
- Spalte „DefaultValue“ der Tabelle „ModuleConfiguration“, wenn die Spalte „Format“ den Wert „Key“ aufweist.
- Konfigurierbare Elemente im Key-Format, die von der Methode ProvideTextData verwendet werden.
Um Literal-Semikolons oder -Gleichheitszeichen in einen Wert im CMSM-Spezialformat einzugeben, setzen Sie dem Zeichen einen umgekehrten Schrägstrich (\) voran. Ein literaler umgekehrter Schrägstrich kann durch zwei umgekehrte Schrägstriche dargestellt werden. Ein einzelnes Zeichen, dem ein einzelner umgekehrter Schrägstrich vorangestellt ist, wird in das einzelne Zeichen übersetzt, auch wenn das Maskieren des Zeichens nicht erforderlich ist.
Wenn einem Semikolon oder Gleichheitszeichen kein umgekehrter Schrägstrich vorangestellt wird, es aber kein definiertes Verhalten im Kontext des Werts aufweist, ist die resultierende Zeichenfolge nicht definiert. Beispielsweise hat die Spalte „DefaultValue“ der Tabelle „ModuleConfiguration“ für alle Key-Elemente das CMSM-Spezialformat, da das Semikolon-Zeichen das Spaltentrennzeichen ist. Obwohl das Gleichheitszeichen in dieser Zeichenfolge keine besondere Bedeutung hat, müssen Literal-Gleichheitszeichen in dieser Zeichen dennoch maskiert werden.