Compartir a través de


Parámetros personalizados

Los parámetros personalizados controlan la operación de un asistente después de que se haya iniciado un asistente. Un archivo .vsz relacionado proporciona una matriz de parámetros definidos por el usuario empaquetados por el entorno de desarrollo integrado (IDE) y que se pasan al asistente como una matriz de cadenas cuando se inicia el asistente. A continuación, el asistente analiza la matriz de cadenas y utiliza la información para gestionar el funcionamiento propio del asistente. De esta manera, un asistente puede personalizar la funcionalidad en función del contenido del archivo .vsz .

Por otro lado, los parámetros de contexto definen el estado del proyecto cuando se inicia el asistente. Para obtener más información, consulte Parámetros de contexto.

A continuación se muestra un ejemplo de un archivo .vsz que tiene parámetros personalizados:

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. Cuando un usuario selecciona Nuevo proyecto o Agregar nuevo elemento en el menú Archivo o haciendo clic con el botón derecho en un proyecto en el Explorador de soluciones, el IDE recopila estos valores en una matriz de cadenas. A continuación, el IDE llama al método AddItem del proyecto con el indicador VSADDITEMOPERATION establecido y el proyecto llama al método RunWizardFile responsable de ejecutar el asistente y devolver el resultado.

El asistente es responsable de analizar la matriz de cadenas y actuar sobre ellas de manera adecuada. De esta manera, mediante la implementación de parámetros personalizados, puede crear un asistente que realice una variedad de funciones. En otras palabras, un asistente podría tener tres archivos .vsz diferentes. Cada archivo pasa diferentes conjuntos de parámetros personalizados para controlar el comportamiento del asistente en varias situaciones.

Para obtener más información, vea Archivo del Asistente (.vsz).