_DTE.LaunchWizard - метод

Статья
11/05/2008

Обновлен: Ноябрь 2007

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

Пространство имен: 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[]%
Обязательный. Параметры мастера. Первый параметр это идентификатор GUID, который уникально идентифицирует контекст запуска, как отличный от Add Item или Add Project, или от пользовательского идентификатора GUID. Остальные элементы определяются пользователем, и их количество и значения зависят от мастера.
Мастера (или шаблоны), которые поставляются вместе с Visual Studio, например приложение Windows Visual Basic или консольное приложение Visual C#, имеют необходимый набор параметров контекста, которые должны быть указаны при их запуске. Дополнительные сведения см. в разделе Контекстные параметры для запуска мастеров. В мастерах, создаваемых пользователем, может использоваться различное число параметров.

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

Тип: 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

Разрешения

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

См. также

Ссылки

_DTE Интерфейс

_DTE - члены

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

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