_DTE.LaunchWizard - метод

Статья
08/11/2011

Запускает мастер с предоставленными параметрами.

Пространство имен: 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, например приложение Windows Visual Basic или консольное приложение Visual C#, имеют необходимый набор параметров контекста, которые должны быть указаны при их запуске.Сведения об этих параметрах см. в описании перечисления ContextParams.В мастерах, создаваемых пользователем, может использоваться различное число параметров.

Возвращаемое значение

Тип: EnvDTE.wizardResult
Объект wizardResult.

Заметки

Главный поток пользовательского интерфейса интегрированной среды разработки является синхронным по отношению к выполнению мастера, поэтому пользователи не могут ничего сделать до завершения работы мастера.

Следующий макрос показывает использование метода 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

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

_DTE Интерфейс

EnvDTE - пространство имен

Поделиться через