_DTE.LaunchWizard 方法
以提供的參數執行精靈。
命名空間: EnvDTE
組件: EnvDTE (在 EnvDTE.dll 中)
語法
'宣告
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
參數
- VSZFile
型別:System.String
必要項。.Vsz (精靈) 檔中有啟動精靈時所需的資訊。
- ContextParams
型別:array<System.Object[]%
必要項。精靈的參數。第一個參數是 GUID,它能唯一地識別出啟動內容,這有別於 Add Item 或 Add Project 或自訂 GUID。其餘的引數為使用者所定義,而且其數目和值是取決於精靈。
Visual Studio 隨附的精靈 (或範本) — 例如 Visual Basic Windows 應用程式或 Visual C# 主控台應用程式 — 具有必須傳遞它們的必要內容參數集。如需關於這些的詳細資訊,請參閱 ContextParams Enum。您所建立的精靈可以包含更多或更少的參數。
傳回值
型別:EnvDTE.wizardResult
wizardResult 物件。
備註
IDE 的主要 UI 執行緒與精靈的執行同步,因此使用者必須等到精靈完成後才能執行動作。
下列巨集範例示範如何使用 LaunchWizard 方法啟動 Visual Studio [加入項目] 精靈。這個精靈會使用七個自訂參數,所以每個參數都會分別設定值。所有例外狀況都由 Try...Catch 區塊攔截。
範例
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 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。