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 usa la información para controlar la operación real 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 Explorador de soluciones, el IDE recopila estos valores en una matriz de cadenas. A continuación, el IDE llama al método del AddItem proyecto con la VSADDITEMOPERATION marca establecida y el proyecto llama al RunWizardFile método responsable de ejecutar el asistente y devolver el resultado.

El asistente es responsable de analizar la matriz de cadenas y actuar en las cadenas de forma 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).