Compartir a través de

DTE2.LaunchWizard (Método) (String, array<Object %)

  • Artículo

Ejecuta un asistente con los parámetros proporcionados.

Espacio de nombres:  EnvDTE80
Ensamblado:  EnvDTE80 (en EnvDTE80.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
    Obligatorio.Archivo .Vsz (asistente) que contiene la información necesaria para iniciar el asistente.
  • ContextParams
    Tipo: array<System.Object[]%
    Obligatorio.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 incluye Visual Studio (como Aplicación para Windows de Visual Basic o Aplicación de consola de Visual C#) necesitan para funcionar que el usuario les pase determinados parámetros de contexto.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
Objeto wizardResult.

Implementaciones

_DTE.LaunchWizard(String, array<Object[]%)

Comentarios

El subproceso de la interfaz de usuario principal del IDE está sincronizado 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 whether it completed, was canceled, and so on.
   Dim res As EnvDTE.wizardResult
   ' Set the project type to a Visual Basic project.
   Dim str As String = _
     DTE.Solution.TemplatePath(VSLangProj.PrjKind.prjKindVBProject)

   ' Start the Visual Basic Console Application wizard by using the
   ' supplied parameters. Exceptions are caught below.
   Try
      res = DTE2.LaunchWizard(str & "ConsoleApplication.vsz", params)
   Catch e1 As System.Exception
      MsgBox("Error: " & e1.Message)
   End Try
End Sub

Seguridad de .NET Framework

Vea también

Referencia

DTE2 Interfaz

LaunchWizard (Sobrecarga)

EnvDTE80 (Espacio de nombres)