_DTE.LaunchWizard (Método)

Ejecuta un asistente con los parámetros proporcionados.

Espacio de nombres:  EnvDTE
Ensamblado:  EnvDTE (en EnvDTE.dll)

Sintaxis

'Declaración
Function LaunchWizard ( _
    VSZFile As String, _
    ByRef ContextParams As Object() _
) As wizardResult

wizardResult LaunchWizard(
    string VSZFile,
    ref Object[] ContextParams
)

wizardResult LaunchWizard(
    [InAttribute] String^ VSZFile, 
    [InAttribute] array<Object^>^% ContextParams
)

abstract LaunchWizard : 
        VSZFile:string * 
        ContextParams:Object[] byref -> wizardResult

function LaunchWizard(
    VSZFile : String, 
    ContextParams : Object[]
) : wizardResult

Parámetros

• VSZFile
  Tipo: String

  Requerido. Archivo .Vsz (asistente) que contiene la información necesaria para iniciar el asistente.

• ContextParams
  Tipo: array<Object[]%

  Requerido. Parámetros correspondientes al asistente. El primer parámetro es un GUID que únicamente identifica el contexto del inicio, a diferencia de Add Item, Add Project o un GUID personalizado. Los argumentos restantes están definidos por el usuario, y su número y valores dependen del asistente.

  Los asistentes (o plantillas) que vienen con Visual Studio, como Aplicación para Windows de Visual Basic o Aplicación de consola de Visual C#, tienen un conjunto necesario de parámetros de contexto que se les debe pasar. Para obtener detalles al respecto, vea ContextParams (Enumeración). Los asistentes que se creen podrán tener más o menos parámetros.

Valor devuelto

Tipo: EnvDTE.wizardResult
Un objeto wizardResult.

Comentarios

El subproceso de la IU principal es sincrónico con la ejecución del asistente, por lo que los usuarios no pueden hacer nada mientras no finalice el asistente.

En el siguiente ejemplo de macro se muestra cómo se utiliza el método LaunchWizard para iniciar el Asistente para agregar elementos de Visual Studio. Este asistente utiliza siete parámetros personalizados, por lo que se establecerán valores para cada uno de ellos. El bloque Try...Catch detectará cualquier excepción.

Ejemplos

Sub LaunchWizardExample()
   Dim params() As Object = New Object() { _
     "{0F90E1D0-4999-11D1-B6D1-00A0C90F2744}", _  ' Param 0
     "MyConsoleProject", _                        ' Param 1
     "C:\MyProjects", _                           ' Param 2
     "", _                                        ' Param 3
     False, _                                     ' Param 4
     "", _                                        ' Param 5
     False}                                       ' Param 6
   ' The wizardResult constant determines the state of the wizard, such 
   ' as did it complete or was it canceled, etc.
   Dim res As EnvDTE.wizardResult
   ' Set the project type to a Visual Basic project.
   Dim s As String = _
     DTE.Solution.TemplatePath(VSLangProj.PrjKind.prjKindVBProject)

   ' Launch the Visual Basic Console Application wizard using the
   ' supplied parameters. Any exceptions are caught below.
   Try
      res = DTE.LaunchWizard(s & "ConsoleApplication.vsz", params)
   Catch e1 As System.Exception
      MsgBox("Error: " & e1.Message)
   End Try
End Sub

Seguridad de .NET Framework

• Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

_DTE Interfaz

EnvDTE (Espacio de nombres)