SerialNumberTemplate 属性

指定一个模板,该模板用于在目标计算机上安装期间验证**“客户信息”**对话框中输入的序列号。

SerialNumberTemplate 属性决定文本框在对话框中的显示方式,并确定是仅对序列号的格式进行验证,还是按照 Windows Installer 算法对序列号进行验证。

例如,将 SerialNumberTemplate 属性设置为“<### - %%%%>”会创建两个文本框,它们由两端加空格的短划线分隔。 对第一个框 (###) 的验证仅验证用户是否已输入三个数字。 第二个框 (%%%%) 是通过将各个数字相加并将所求得的和除以 7 这样的算法进行验证的。 如果余数为 0,则验证成功;否则,验证失败。

可编辑字符以文本框内的占位符的形式出现在**“客户信息”**对话框中;其他任何字符则以标签的形式出现在文本框之间。

提示

每次更改可编辑字符时都会创建一个单独的文本框,例如,输入“#? %”会创建三个文本框,每个文本框接受一个字符。

设置

SerialNumberTemplate 属性的有效可编辑字符如下所示:

字符

含义

#

要求输入一个数字,该数字将不包括在验证算法中。

%

要求输入一个数字,该数字将包括在验证算法中。

?

要求输入一个字母数字字符,该字符将不包括在验证算法中。

^

需要大写或小写字符。 在此处输入数字是无效的。

<

该字符左边的所有字符在对话框中都不可见。

>

该字符右边的所有字符在对话框中都不可见。 如果使用 < 字符,则需要输入它作为结束符。

任何其他字符都被视为文本常数。

备注

如果 ShowSerialNumber 属性设置为 true,则在允许用户移动到下一个安装步骤之前,根据 SerialNumberTemplate 属性中指定的模板对序列号进行验证。 如果 ShowSerialNumber 属性设置为 false,则 SerialNumberTemplate 属性无效。

请参见

参考

“用户界面编辑器”的属性

ShowSerialNumber 属性

其他资源

PIDTemplate 属性 (Windows)

ValidateProductID 操作 (Windows)

MaskedEdit 控件 (Windows)