DTE2.LaunchWizard, méthode (String, array<Object %)

Article
08/10/2011

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 : System.String
Obligatoire.Fichier .Vsz (Assistant) contenant les informations nécessaires au lancement de l'Assistant.

ContextParams
Type : array<System.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 : EnvDTE.wizardResult
Objet wizardResult.

Implémentations

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

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

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.