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.

Note

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

ShowSerialNumber, propriété

Autres ressources

Propriété PIDTemplate (Windows)

Action ValidateProductID (Windows)

Contrôle MaskedEdit (Windows)