_DTE.LaunchWizard 方法

更新:2007 年 11 月

用提供的参数运行向导。

命名空间:  EnvDTE
程序集:  EnvDTE(在 EnvDTE.dll 中)

语法

声明
Function LaunchWizard ( _
    VSZFile As String, _
    ByRef ContextParams As Object() _
) As wizardResult
用法
Dim instance As _DTE
Dim VSZFile As String
Dim ContextParams As Object()
Dim returnValue As wizardResult

returnValue = instance.LaunchWizard(VSZFile, _
    ContextParams)
wizardResult LaunchWizard(
    string VSZFile,
    ref Object[] ContextParams
)
wizardResult LaunchWizard(
    [InAttribute] String^ VSZFile, 
    [InAttribute] array<Object^>^% ContextParams
)
function LaunchWizard(
    VSZFile : String, 
    ContextParams : Object[]
) : wizardResult

参数

  • VSZFile
    类型:System.String

    必需。.Vsz(向导)文件包含启动向导所需的信息。

  • ContextParams
    类型:array<System.Object[]%

    必需。向导的参数。第一个参数是唯一标识启动上下文,以使其不同于 Add ItemAdd Project 的 GUID 或自定义的 GUID。其余的参数是用户定义的,它们的数目和值取决于向导。

    随 Visual Studio(如 Visual Basic Windows 应用程序或 Visual C# 控制台应用程序)一起提供的向导(或模板)有一组您必须传递给它们的上下文参数。有关这些参数的详细信息,请参见 用于启动向导的上下文参数。您创建的向导可以有或多或少的参数。

返回值

类型:EnvDTE.wizardResult

一个 wizardResult 对象。

备注

IDE 的主 UI 线程与向导的执行同步,因此用户在向导完成前无法执行任何操作。

下面的宏示例说明如何使用 LaunchWizard 方法启动 Visual Studio“添加项”向导。该向导使用 7 个自定义参数,以便设置每个参数的值。任何异常由 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

权限

另请参见

参考

_DTE 接口

_DTE 成员

EnvDTE 命名空间