Compartir a través de


_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: System.String
    Requerido.Archivo .Vsz (asistente) que contiene la información necesaria para iniciar el asistente.
  • ContextParams
    Tipo: array<System.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

Vea también

Referencia

_DTE Interfaz

EnvDTE (Espacio de nombres)