Método _DTE.LaunchWizard

Artigo
08/01/2011

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: System.String
Obrigatório.A.Arquivo vsz (Assistente) que contém as informações necessárias para iniciar o assistente.

ContextParams
Tipo: array<System.Object[]%
Obrigatório.Os parâmetros para o assistente.O primeiro parâmetro é um GUID que identifica exclusivamente o contexto de inicialização diferentes de Add Item ou Add Project ou GUID personalizada.Os argumentos restantes são definidos pelo usuário e seus valores e o número dependem do assistente.
Assistentes (ou modelos) que acompanham o Visual Studio — como Visual Basic aplicativo do Windows ou Visual C# aplicativo de Console — têm um conjunto necessário de parâmetros de contexto, você deve passar a eles.Para obter detalhes sobre elas, consulte a enumeração de ContextParams.Assistentes que você criar podem ter mais ou menos parâmetros.

Valor de retorno

Tipo: EnvDTE.wizardResult
A wizardResult objeto.

Comentários

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

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

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áveis.

Consulte também

Referência

_DTE Interface

Namespace EnvDTE

Compartilhar via