Partager via


DTE2.LaunchWizard, méthode

Exécute un Assistant avec les paramètres fournis.

Espace de noms :  EnvDTE80
Assembly :  EnvDTE80 (dans EnvDTE80.dll)

Syntaxe

'Déclaration
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

Paramètres

  • VSZFile
    Type : String

    Obligatoire. Fichier .Vsz (Assistant) contenant les informations nécessaires au lancement de l'Assistant.

  • ContextParams
    Type : array<Object[]%

    Obligatoire. Les paramètres de l'Assistant. Le premier paramètre est un GUID identifiant de façon unique le contexte de lancement en le distinguant de Add Item, de Add Project ou d'un GUID personnalisé. Les autres arguments sont définis par l'utilisateur. Leur nombre et leurs valeurs dépendent de l'Assistant.

    Les Assistants (ou modèles) fournis avec Visual Studio (comme Application Windows Visual Basic ou Application console Visual C#) requièrent un ensemble de paramètres de contexte que vous devez leur passer. Pour plus d'informations sur ces derniers, consultez l'enum ContextParams. Les Assistants que vous créez peuvent avoir plus ou moins de paramètres.

Valeur de retour

Type : wizardResult
Objet wizardResult.

Notes

Le thread d'interface utilisateur principal de l'environnement IDE est synchrone avec l'exécution de l'Assistant. Par conséquent, les utilisateurs ne peuvent effectuer aucune opération tant que l'exécution de l'Assistant n'est pas terminée.

L'exemple de macro ci-dessous montre comment utiliser la méthode LaunchWizard pour lancer l'Assistant AddItem de Visual Studio. Cet Assistant utilise sept paramètres personnalisés. Des valeurs sont définies pour chacun d'eux. Les éventuelles exceptions sont interceptées par le bloc Try...Catch.

Exemples

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

Sécurité .NET Framework

Voir aussi

Référence

DTE2 Interface

EnvDTE80, espace de noms