DTE2.LaunchWizard(String, Object[]) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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.