Freigeben über


DTE2.LaunchWizard-Methode (String, array<Object %)

Führt einen Assistenten mit den angegebenen Parametern aus.

Namespace:  EnvDTE80
Assembly:  EnvDTE80 (in EnvDTE80.dll)

Syntax

'Declaration
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

Parameter

  • VSZFile
    Typ: System.String
    Erforderlich.Die VSZ (Assistenten)-Datei, die die für den Start des Assistenten erforderlichen Informationen enthält.
  • ContextParams
    Typ: array<System.Object[]%
    Erforderlich.Die Parameter für den Assistenten.Beim ersten Parameter handelt es sich um eine GUID, die den Startkontext eindeutig von Add Item oder Add Project oder einer benutzerdefinierten GUID unterscheidet.Die übrigen Argumente sind benutzerdefiniert. Anzahl und Werte hängen vom jeweiligen Assistenten ab.
    Assistenten (oder Vorlagen), die in Visual Studio enthalten sind, wie z. B. Windows-Anwendung in Visual Basic oder Konsolenanwendung in Visual C#, verfügen über erforderliche Kontextparameter, die übergeben werden müssen.Details dazu finden Sie unter "ContextParams-Enumeration".Von Ihnen erstellte Assistenten können mehr oder weniger Parameter aufweisen.

Rückgabewert

Typ: EnvDTE.wizardResult
Ein wizardResult-Objekt.

Implementiert

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

Hinweise

Der Hauptthread der Benutzeroberfläche der IDE ist zur Ausführung des Assistenten synchron, daher können Benutzer bis zum Abschluss des Assistenten keine Aktionen ausführen.

Das folgende Makrobeispiel veranschaulicht die Verwendung der LaunchWizard-Methode, um den Visual Studio-Assistenten zum Hinzufügen von Elementen zu starten. Dieser Assistent verwendet sieben benutzerdefinierte Parameter, deren Werte daher einzeln festgelegt werden. Alle Ausnahmen werden vom Try...Catch-Block abgefangen.

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

.NET Framework-Sicherheit

Siehe auch

Referenz

DTE2 Schnittstelle

LaunchWizard-Überladung

EnvDTE80-Namespace