SerialNumberTemplate, propriété
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 la 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.
Notes
Une autre zone de texte est créée à chaque fois que le caractère modifiable est modifié, par exemple, "#? %" crée trois zones de texte, chacune acceptant un caractère.
Paramètres
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.
Voir aussi
Référence
Propriétés de l'Éditeur de l'interface utilisateur
Autres ressources
Propriété PIDTemplate (Windows)