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

Executa um assistente com os parâmetros fornecidos.

Namespace:  EnvDTE80
Assembly:  EnvDTE80 (em EnvDTE80.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 do aplicativo de Console do Visual C# — 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 parâmetros mais ou menos.

Valor de retorno

Tipo: EnvDTE.wizardResult
A wizardResult objeto.

Implementações

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

Comentários

O segmento de interface (UI) 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 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

Segurança do .NET Framework

Consulte também

Referência

DTE2 Interface

Sobrecargas LaunchWizard

Namespace EnvDTE80