Método _DTE.LaunchWizard

Artigo
05/17/2015

Executa um assistente com os parâmetros fornecidos.

Namespace: EnvDTE
Assembly: EnvDTE (em EnvDTE.dll)

Sintaxe

'Declaração
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

Obrigatório. . Arquivo de Vsz (assistente) que contém informações necessárias para iniciar o assistente.

ContextParams
Tipo: array<Object[]%

Obrigatório. Os parâmetros para o assistente. O primeiro parâmetro é o que identifica unicamente o contexto de lançamento a diferença de Add Item ou Add Project ou GUID personalizado. Os argumentos restantes são definidos pelo usuário e seus número e valores dependem do assistente.

Os assistentes (ou modelos) que vem com Visual Studio — como aplicativos do Windows de Visual Basic ou o console de Visual C# aplicativo tem um conjunto necessária de parâmetros de contexto que você deve passar. Para obter detalhes sobre esses, consulte enum de ContextParams. Assistentes que você cria pode ter mais ou menos parâmetros.

Valor de retorno

Tipo: EnvDTE.wizardResult
Um objeto wizardResult.

Comentários

O segmento principal de interface de usuário do IDE é síncrona com a execução do assistente, para que os usuários não podem fazer nada até que o assistente terminar.

O exemplo a seguir macro demonstra como usar o método de LaunchWizard para iniciar Visual Studio adiciona o assistente de item. O assistente sete usa parâmetros personalizados, para que os valores são definidos para cada um. Todas as exceções são detectadas pelo bloco de Try...Catch .

Exemplos

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

_DTE Interface

Namespace EnvDTE

Compartilhar via