_DTE.LaunchWizard-Methode
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: StringErforderlich. 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.