Parámetros personalizadosCustom parameters

Parámetros personalizados controlan el funcionamiento de un asistente después de que se ha iniciado un asistente.Custom parameters control the operation of a wizard after a wizard has started. Un relacionados .vsz archivo proporciona una matriz de parámetros definido por el usuario que se empaquetan en el entorno de desarrollo integrado (IDE) y se pasa al asistente como una matriz de cadenas cuando se inicia el asistente.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. A continuación, el asistente analiza la matriz de cadenas y usa la información para controlar la operación real del asistente.The wizard then parses the array of strings and uses the information to control the actual operation of the wizard. De esta manera, un asistente puede personalizar la funcionalidad según el contenido de la .vsz archivo.In this manner, a wizard can customize functionality depending on the contents of the .vsz file.

Parámetros de contexto, por otro lado, definen el estado del proyecto cuando se inicia el asistente.Context parameters, on the other hand, define the state of the project when the wizard is started. Para obtener más información, consulte parámetros de contexto.For more information, see Context parameters.

Este es un ejemplo de un .vsz archivo que tiene parámetros personalizados: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"  

El autor de la .vsz archivo agrega los valores de los parámetros.The author of the .vsz file adds the values of the parameters. Cuando un usuario selecciona nuevo proyecto o Agregar nuevo elemento en el archivo menú o con el botón secundario en un proyecto de el Explorador de soluciones, el IDE recopila estos valores en una matriz de cadenas.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. El IDE, a continuación, llama el proyecto AddItem método con el VSADDITEMOPERATION marca conjunto y las llamadas de proyecto la RunWizardFile método que es responsable de ejecutar el asistente y devolviendo el resultado.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.

El asistente es responsable de la matriz de cadenas de análisis y actuar sobre las cadenas de manera apropiada.The wizard is responsible for parsing the array of strings and acting on the strings appropriately. De esta manera, mediante la implementación de parámetros personalizados puede crear a un asistente que realiza una serie de funciones.In this manner, by implementing custom parameters you can create one wizard that performs a variety of functions. En otras palabras, un asistente podría tener tres diferentes .vsz archivos.In other words, one wizard could have three different .vsz files. Cada archivo pasa a diferentes conjuntos de parámetros personalizados para controlar el comportamiento del asistente en diversas situaciones.Each file passes different sets of custom parameters to control the behavior of the wizard in various situations.

Para obtener más información, consulte archivo asistentes (.vsz).For more information, see Wizard (.vsz) file.

Vea tambiénSee also

IVsProject3
Parámetros de contexto Context parameters
Asistentes Wizards
Archivos de asistentes (.vsz)Wizard (.vsz) file