DTE2.LaunchWizard(String, Object[]) Methode

Definition

Führt einen Assistenten mit den angegebenen Parametern aus.Runs a wizard with the supplied parameters.

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

Parameter

VSZFile
String

Erforderlich.Required. Die VSZ (Assistenten)-Datei, die die für den Start des Assistenten erforderlichen Informationen enthält.The .Vsz (wizard) file containing the information required to launch the wizard.

ContextParams
Object[]

Erforderlich.Required. Die Parameter für den Assistenten.The parameters for the wizard. Beim ersten Parameter handelt es sich um eine GUID, die den Startkontext eindeutig von Add Item oder Add Project oder einer benutzerdefinierten GUID unterscheidet.The first parameter is a GUID that uniquely identifies the launch context as distinct from Add Item or Add Project or a custom GUID. Die übrigen Argumente sind benutzerdefiniert. Anzahl und Werte hängen vom jeweiligen Assistenten ab.The remaining arguments are user-defined and their number and values depend on the wizard.

Die in Visual StudioVisual Studio enthaltenen Assistenten (oder Vorlagen), z. B. Visual BasicVisual Basic-Windows-Anwendung oder Visual C#-Konsolenanwendung, benötigen einen bestimmten Satz von Kontextparametern, die übergeben werden müssen.Wizards (or templates) that come with Visual StudioVisual Studio — such as Visual BasicVisual Basic Windows Application or Visual C# Console Application — have a required set of context parameters that you must pass to them. Details dazu finden Sie unter "ContextParams-Enumeration".For details on these, see ContextParams Enum. Die von Ihnen erstellten Assistenten können mehr oder weniger Parameter aufweisen.Wizards that you create can have more or fewer parameters.

Gibt zurück

wizardResult

Ein wizardResult-Objekt.A wizardResult object.

Implementiert

Attribute

Beispiele

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  

Hinweise

Der Hauptbenutzer Oberflächen-Thread der IDE ist mit der Ausführung des Assistenten synchron, sodass Benutzer keine Aktionen ausführen können, bis der Assistent abgeschlossen ist.The main user interface (UI) thread of the IDE is synchronous with the wizard's execution, so users cannot do anything until the wizard completes.

Im folgenden Beispiel wird veranschaulicht, wie die- LaunchWizard Methode verwendet wird, um den Assistenten zum Hinzufügen von Elementen zu starten Visual StudioVisual Studio .The following macro example demonstrates how to use the LaunchWizard method to launch the Visual StudioVisual Studio Add Item wizard. Dieser Assistent verwendet sieben benutzerdefinierte Parameter, sodass Werte für jeden Parameter festgelegt werden.This wizard uses seven custom parameters, so values are set for each one. Alle Ausnahmen werden vom- Try...Catch Block abgefangen.Any exceptions are caught by the Try...Catch block.

Gilt für: