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 archivo .vsz relacionados proporciona una matriz de parámetros definidos por el usuario que se empaquetada por 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 utiliza 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 del archivo .vsz.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.

Aquí te mostramos un ejemplo de un archivo .vsz 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 del archivo .vsz 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 menú archivo, o haciendo clic en un proyecto en 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 llama, a continuación, 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 devolver 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 en 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 archivos .vsz diferentes.In other words, one wizard could have three different .vsz files. Cada archivo pasa 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, vea asistente (. Archivo 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