_DTE.LaunchWizard-Methode

Artikel
05/16/2015

Führt einen Assistenten mit den angegebenen Parametern aus.

Namespace: EnvDTE
Assembly: EnvDTE (in EnvDTE.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: String

Erforderlich. Die VSZ (Assistenten)-Datei, die die für den Start des Assistenten erforderlichen Informationen enthält.

ContextParams
Typ: array<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.

Die in Visual Studio enthaltenen Assistenten (oder Vorlagen), wie Visual Basic-Windows-Anwendung oder Visual C#-Konsolenanwendung, benötigen einen bestimmten Satz von Kontextparametern, die Sie an sie übergeben müssen. Details dazu finden Sie unter "ContextParams-Enumeration". Assistenten, die Sie erstellen, können mehr oder weniger Parameter aufweisen.

Rückgabewert

Typ: EnvDTE.wizardResult
Ein wizardResult-Objekt.

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 did it complete or was it canceled, etc.
   Dim res As EnvDTE.wizardResult
   ' Set the project type to a Visual Basic project.
   Dim s As String = _
     DTE.Solution.TemplatePath(VSLangProj.PrjKind.prjKindVBProject)

   ' Launch the Visual Basic Console Application wizard using the
   ' supplied parameters. Any exceptions are caught below.
   Try
      res = DTE.LaunchWizard(s & "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.

Siehe auch

Referenz

_DTE Schnittstelle

EnvDTE-Namespace

Share via