DTE2.LaunchWizard - метод (String, array<Object[]%)

Статья
11/05/2008

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

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

Пространство имен: EnvDTE80
Сборка: EnvDTE80 (в EnvDTE80.dll)

Синтаксис

'Декларация
Function LaunchWizard ( _
    VSZFile As String, _
    ByRef ContextParams As Object() _
) As wizardResult
'Применение
Dim instance As DTE2
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 C#" Visual Basic, имеют необходимый набор параметров контекста, которые нужно им передать. Дополнительные сведения об этом см. в разделе Контекстные параметры для запуска мастеров. В мастерах, создаваемых пользователем, может использоваться различное число параметров.

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

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

Реализации

_DTE.LaunchWizard(String, array<Object[]%)

Заметки

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

Следующий макрос показывает использование метода 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 whether it completed, was canceled, and so on.
   Dim res As EnvDTE.wizardResult
   ' Set the project type to a Visual Basic project.
   Dim str As String = _
     DTE.Solution.TemplatePath(VSLangProj.PrjKind.prjKindVBProject)

   ' Start the Visual Basic Console Application wizard by using the
   ' supplied parameters. Exceptions are caught below.
   Try
      res = DTE2.LaunchWizard(str & "ConsoleApplication.vsz", params)
   Catch e1 As System.Exception
      MsgBox("Error: " & e1.Message)
   End Try
End Sub

Разрешения

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