Compartir a través de

Parámetros de contexto para iniciar asistentes

  • Artículo

Los complementos de Visual Studio están desusados en Visual Studio 2013. Debe actualizar los complementos a las extensiones de VSPackage. Para obtener más información sobre la actualización, vea Preguntas más frecuentes: Convertir complementos en extensiones de VSPackage.

Los parámetros de contexto proporcionan información necesaria para iniciar un asistente, como, por ejemplo, el tipo de asistente que ha de utilizarse, el nombre del proyecto, los directorios para los elementos del asistente, etc.

Existen tres tipos diferentes de asistentes:

  • NewProject: agrega un nuevo proyecto a una solución.

  • AddSubProject: agrega un subproyecto a un proyecto existente.

  • AddItem: agrega un elemento a un proyecto existente.

Los tres tipos de asistentes se invocan a través del método Execute de la interfaz IDTWizard. Un parámetro necesario del método Execute es ContextParams. Cada tipo requiere un conjunto diferente de valores ContextParams en el orden correcto, como se indica en la tabla siguiente:

Tipo de asistente

Parámetros usados

NewProject

  • WizardType

  • ProjectName

  • LocalDirectory

  • InstallationDirectory

  • FExclusive

  • SolutionName

  • Silent

AddSubProject

  • WizardType

  • ProjectName

  • ProjectItems

  • LocalDirectory

  • ItemName

  • InstallationDirectory

  • Silent

AddItem

  • WizardType

  • ProjectName

  • ProjectItems

  • LocalDirectory

  • ItemName

  • InstallationDirectory

  • Silent

En la tabla siguiente se enumeran todos los parámetros de contexto y sus descripciones:

Parámetro

Descripción

WizardType

Constante que indica el tipo de asistente. Existen tres tipos:

  • vsWizardNewProject (GUID = "{0F90E1D0-4999-11D1-B6D1-00A0C90F2744}")

  • vsWizardAddItem (GUID = "{0F90E1D1-4999-11D1-B6D1-00A0C90F2744}")

  • vsWizardAddSubProject (GUID = "{0F90E1D2-4999-11D1-B6D1-00A0C90F2744}")

ProjectName

Nombre del proyecto.

ProjectItems

Puntero a la colección ProjectItems en la que funcionará el asistente. Se pasa al asistente basándose en la selección de jerarquía del proyecto.

LocalDirectory

Ubicación en el sistema local donde residen los archivos de proyecto de trabajo del asistente.

ItemName

Nombre del elemento que se va a agregar. ItemName es el nombre de archivo que escribe el usuario (o que se acepta de forma predeterminada) en el cuadro de diálogo Agregar elemento. En función de las marcas establecidas en el archivo VSDIR, este parámetro puede ser NULL.

InstallationDirectory

Ruta de acceso del directorio donde se instala Visual Studio.

FExclusive

Valor booleano que indica si el proyecto debe ser exclusivo para sí mismo. Esto es, si se debe agregar el proyecto a la solución actual o si el sistema cierra la solución actual, crea una nueva y después agrega el proyecto a esta.

SolutionName

Nombre para el archivo de solución sin la parte del directorio o la extensión .sln. (El nombre de archivo .suo también se basa en este nombre raíz). Si SolutionName contiene un valor (es decir, no es una cadena vacía), el asistente para NewProject llama al método Create antes de agregar el proyecto con AddFromTemplate. Sin embargo, si SolutionName es una cadena vacía, no es necesario llamar al método Create antes de llamar a AddFromTemplate.

Silent

Valor booleano que indica si el asistente se debe ejecutar sin notificación, sin mostrar ninguna interfaz de usuario (IU), y tomar todos los valores predeterminados. El valor predeterminado de Silent es True.

Vea también

Referencia

Execute

IDTWizard

Conceptos

Agregar asistentes a los cuadros de diálogo Agregar elemento y Nuevo proyecto mediante el uso de archivos .Vsdir