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

Artikel
08/10/2011

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

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.