SerialNumberTemplate, propriété
Mise à jour : novembre 2007
Spécifie un modèle utilisé pour valider une entrée de numéro de série dans une boîte de dialogue Informations client au cours de l'installation sur un ordinateur cible.
La propriété SerialNumberTemplate détermine la manière dont les zones de texte apparaissent dans la boîte de dialogue, ainsi que le mode de validation du numéro de série, c'est-à-dire selon son format ou un algorithme de Windows Installer.
En affectant, par exemple, la valeur "<### - %%%%>" à la propriété SerialNumberTemplate, vous créez deux zones de texte séparées par un tiret et entourées d'espaces. La validation de la première zone (###) vérifie simplement si l'utilisateur a entré trois chiffres. La deuxième zone (%%%%) est validée par un algorithme qui additionne les chiffres et divise leur somme par 7. Si le reste est 0, la validation réussit. Sinon, elle échoue.
Des caractères modifiables apparaissent dans la boîte de dialogue Informations client en tant qu'espaces réservés dans les zones de texte. Tous les autres caractères apparaissent en tant qu'étiquettes entre les zones de texte.
.gif "Remarque") Remarque : |
|---|
Une zone de texte distincte est créée chaque fois que le caractère modifiable est changé. Par exemple, entrer "#?%" crée trois zones de texte acceptant chacune un caractère. |
Valeurs
La propriété SerialNumberTemplate accepte les caractères modifiables valides suivants :
Caractère |
Signification |
|---|---|
# |
Exige un chiffre qui n'est pas inclus dans l'algorithme de validation. |
% |
Exige un chiffre qui est inclus dans l'algorithme de validation. |
? |
Exige un caractère alphanumérique qui n'est pas inclus dans l'algorithme de validation. |
^ |
Exige un caractère majuscule ou minuscule. Les chiffres ne sont pas valides ici. |
< |
Tout caractère situé à gauche de ce caractère ne s'affiche pas dans la boîte de dialogue. |
> |
Tout caractère situé à droite de ce caractère s'affiche dans la boîte de dialogue. Obligatoire comme caractère de fin en cas d'utilisation du caractère <. |
Tout autre caractère est traité comme une constante littérale.
Notes
Si la propriété ShowSerialNumber a la valeur true, le numéro de série est validé par rapport au modèle spécifié dans la propriété SerialNumberTemplate avant que l'utilisateur ne puisse passer à l'étape suivante de l'installation. Si la propriété ShowSerialNumber a la valeur false, la propriété SerialNumberTemplate est sans effet.