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

Статья
11/01/2012

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

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

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

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

Заметки

Главный поток пользовательского интерфейса в среде 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

Безопасность платформы .NET Framework

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

См. также

Ссылки

DTE2 Интерфейс

LaunchWizard - перегрузка

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

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