Paramètres personnalisésCustom parameters

Paramètres personnalisés contrôlent le fonctionnement d’un Assistant après le démarrage d’un Assistant.Custom parameters control the operation of a wizard after a wizard has started. Un connexes .vsz fichier fournit un tableau de paramètres définis par l’utilisateur qui sont empaquetées par l’environnement de développement intégré (IDE) et passé à l’Assistant sous forme de tableau de chaînes au démarrage de l’Assistant.A related .vsz file provides an array of user-defined parameters that are packaged by the integrated development environment (IDE) and passed to the wizard as an array of strings when the wizard is started. Ensuite, l’Assistant analyse le tableau de chaînes et utilise les informations pour contrôler le fonctionnement réel de l’Assistant.The wizard then parses the array of strings and uses the information to control the actual operation of the wizard. De cette manière, un Assistant peut personnaliser les fonctionnalités en fonction du contenu de la .vsz fichier.In this manner, a wizard can customize functionality depending on the contents of the .vsz file.

Paramètres de contexte, quant à eux, définissent l’état du projet que lorsque l’Assistant est démarré.Context parameters, on the other hand, define the state of the project when the wizard is started. Pour plus d’informations, consultez paramètres de contexte.For more information, see Context parameters.

Voici un exemple d’un .vsz fichier qui a des paramètres personnalisés :Following is an example of a .vsz file that has custom parameters:

VSWIZARD 8.0
Wizard=VsWizard.VsWizard_Engine
Param="WIZARD_NAME = Sample Wizard"
Param="WIZARD_UI = FALSE"
Param="RELATIVE_PATH = VSWizards\Classwiz\ATL"
Param="PREPROCESS_FUNCTION = CanAddATLSupport"
Param="PROJECT_TYPE = CSPROJ"

L’auteur de la .vsz fichier ajoute les valeurs des paramètres.The author of the .vsz file adds the values of the parameters. Lorsqu’un utilisateur sélectionne nouveau projet ou ajouter un nouvel élément sur le fichier menu ou en double-cliquant sur un projet dans l’Explorateur de solutions, l’IDE collecte ces valeurs dans un tableau de chaînes.When a user selects New Project or Add New Item on the File menu or by right-clicking a project in Solution Explorer, the IDE collects these values into an array of strings. L’IDE puis appelle le projet AddItem méthode avec le VSADDITEMOPERATION indicateur ensemble et les appels de projet la RunWizardFile méthode qui est responsable de l’exécution de l’Assistant et en retournant le résultat.The IDE then calls the project's AddItem method with the VSADDITEMOPERATION flag set, and the project calls the RunWizardFile method that is responsible for running the wizard and returning the result.

L’Assistant est responsable de l’analyse du tableau de chaînes et agir sur les chaînes en conséquence.The wizard is responsible for parsing the array of strings and acting on the strings appropriately. De cette manière, en implémentant des paramètres personnalisés, vous pouvez créer un Assistant qui effectue un éventail de fonctions.In this manner, by implementing custom parameters you can create one wizard that performs a variety of functions. En d’autres termes, un Assistant peut avoir trois différentes .vsz fichiers.In other words, one wizard could have three different .vsz files. Chaque fichier transmet différents jeux de paramètres personnalisés pour contrôler le comportement de l’Assistant dans diverses situations.Each file passes different sets of custom parameters to control the behavior of the wizard in various situations.

Pour plus d’informations, consultez fichier Assistant (.vsz).For more information, see Wizard (.vsz) file.

Voir aussiSee also