DTE2.LaunchWizard(String, Object[]) Méthode

Définition

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

public:
 EnvDTE::wizardResult LaunchWizard(System::String ^ VSZFile, cli::array <System::Object ^> ^ % ContextParams);
EnvDTE::wizardResult LaunchWizard(std::wstring const & VSZFile, std::Array <winrt::Windows::Foundation::IInspectable const &> const & & ContextParams);
[System.Runtime.InteropServices.DispId(232)]
public EnvDTE.wizardResult LaunchWizard (string VSZFile, ref object[] ContextParams);
[<System.Runtime.InteropServices.DispId(232)>]
abstract member LaunchWizard : string * Object[] -> EnvDTE.wizardResult
Public Function LaunchWizard (VSZFile As String, ByRef ContextParams As Object()) As wizardResult

Paramètres

VSZFile
String

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

ContextParams
Object[]

Obligatoire. 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.

Retours

wizardResult

Objet wizardResult.

Implémente

Attributs

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  

Remarques

Le thread d’interface utilisateur principal de l’IDE est synchrone avec l’exécution de l’Assistant, afin que les utilisateurs ne puissent rien faire tant que l’Assistant n’est pas terminé.

L’exemple de macro suivant montre comment utiliser la LaunchWizard méthode pour lancer l' Visual Studio Assistant Ajout d’élément. Cet Assistant utilise sept paramètres personnalisés, donc les valeurs sont définies pour chacun d’entre eux. Toutes les exceptions sont interceptées par le Try...Catch bloc.

S’applique à