Método DTE2.LaunchWizard

Artigo
05/17/2015

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: String

Obrigatório. A.Arquivo vsz (Assistente) que contém as informações necessárias para iniciar o assistente.

ContextParams
Tipo: array<Object[]%

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

Assistentes (ou modelos) que vêm com o Visual Studio — como Visual Basic aplicativo do Windows ou do aplicativo de Console do Visual C# — um conjunto necessário de parâmetros de contexto que 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: wizardResult
A wizardResult object.

Comentários

O segmento de interface (UI) do usuário principal do IDE é síncrono com 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 assistente Add Item. Este assistente usa sete parâmetros personalizados, para que 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

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

DTE2 Interface

Namespace EnvDTE80

Compartilhar via